update readme, index

docs/index.md

@@ -1 +1,34 @@
+<p>
+  <img src="assets/cmba-logo.svg" width="300" alt="CMBA logo">
+</p>
 # CMBA Bylaws, Policy, and Playing Rules
+
+Welcome to the governing documents for the Chicago Metropolitan Baseball Association.
+
+This site brings together the league's core rules in a single place so managers, players, and league officials can quickly find the current governing text.
+
+## Documents
+
+- [League Bylaws](01-bylaws.md): the league's organizational structure, board authority, membership framework, meetings, and amendment process
+- [League Policy](02-policy.md): league operations, procedures, discipline, administration, and competition governance
+- [Playing Rules](03-playing-rules.md): on-field rules, lineup formats, game administration, and incorporated baseball rules
+
+## How to Use This Site
+
+- Start with the Bylaws for questions about league authority, governance, and membership.
+- Use League Policy for operational questions, discipline, roster administration, and league procedures.
+- Use Playing Rules for game-day and on-field questions.
+
+## Rule Hierarchy
+
+If documents overlap or appear to conflict, the controlling order is generally:
+
+1. Bylaws
+2. League Policy
+3. Playing Rules
+
+For on-field administration, the Playing Rules also incorporate the Official Baseball Rules of Major League Baseball except where CMBA rules provide otherwise.
+
+## About the CMBA
+
+The Chicago Metropolitan Baseball Association exists to provide strong amateur baseball competition in Illinois and the Midwest, with an emphasis on competitive play, sportsmanship, and league continuity.