add guidance for pregame warmups

.github/workflows/ci-docs.yml

@@ -2,6 +2,10 @@ name: CI - Docs build check
 
 on:
   push: 
+    tags:
+      - "draft*"
+      - "rc*"
+      - "v*"
     branches:
       - main
       - draft
@@ -47,6 +51,12 @@ jobs:
         run: |
           set -euo pipefail
           echo "Strict is set to ${MKDOCS_STRICT}"
+          REPO_SLUG="${GITHUB_REPOSITORY#*/}"
+          MKDOCS_SITE_URL="https://${GITHUB_REPOSITORY_OWNER}.github.io/${REPO_SLUG}/"
+          MKDOCS_REPO_URL="https://github.com/${GITHUB_REPOSITORY}/tree/${GITHUB_REF_NAME}"
+          MKDOCS_REPO_NAME="${GITHUB_REPOSITORY}"
+          export MKDOCS_SITE_URL MKDOCS_REPO_URL MKDOCS_REPO_NAME
+
           FLAGS=()
 
           if [ "${MKDOCS_STRICT}" = "true" ]; then
@@ -54,4 +64,4 @@ jobs:
           fi
           MKDOCS_OUTPUT_DIR="${RUNNER_TEMP:-${TMPDIR:-/tmp}}/dist"
            
-          mkdocs build "${FLAGS[@]}" -f "${MKDOCS_CONFIG}" -d "${MKDOCS_OUTPUT_DIR}"
+          mkdocs build "${FLAGS[@]}" -f "${MKDOCS_CONFIG}" -d "${MKDOCS_OUTPUT_DIR}"

.github/workflows/release.yml

@@ -1,4 +1,4 @@
-name: Build & publish docs (rc + release)
+name: Build & publish
 
 on:
   push:
@@ -48,6 +48,21 @@ jobs:
         run: |
           set -euo pipefail
 
+          REPO_SLUG="${GITHUB_REPOSITORY#*/}"
+          BASE_SITE_URL="https://${GITHUB_REPOSITORY_OWNER}.github.io/${REPO_SLUG}/"
+          MKDOCS_REPO_URL="https://github.com/${GITHUB_REPOSITORY}/tree/${GITHUB_REF_NAME}"
+          MKDOCS_REPO_NAME="${GITHUB_REPOSITORY}"
+
+          if [[ "${GITHUB_REF_NAME}" == draft* ]]; then
+            MKDOCS_SITE_URL="${BASE_SITE_URL}draft/"
+          elif [[ "${GITHUB_REF_NAME}" == rc* ]]; then
+            MKDOCS_SITE_URL="${BASE_SITE_URL}rc/"
+          else
+            MKDOCS_SITE_URL="${BASE_SITE_URL}"
+          fi
+
+          export MKDOCS_SITE_URL MKDOCS_REPO_URL MKDOCS_REPO_NAME
+
           FLAGS=()
           if [ "${MKDOCS_STRICT}" = "true" ]; then
             FLAGS+=(--strict)
@@ -72,6 +87,7 @@ jobs:
 
           OUT_DIR="${RUNNER_TEMP}/pandoc"
           OUT_FILE="${GITHUB_REF_NAME}-${SHORT_SHA}.docx"
+          PLAYING_RULES_OUT_FILE="${GITHUB_REF_NAME}-${SHORT_SHA}-playing-rules.docx"
           echo "SHORT_SHA=`echo ${SHORT_SHA}`" >> $GITHUB_ENV
 
           mkdir -p "${OUT_DIR}"
@@ -94,12 +110,36 @@ jobs:
           
           echo "Pandoc output written to ${OUT_DIR}/${OUT_FILE}"
 
+          echo "Generating ${PLAYING_RULES_OUT_FILE}"
+
+          pandoc \
+            docs/03-playing-rules.md \
+            --shift-heading-level-by=-1 \
+            --number-sections \
+            -o "${OUT_DIR}/${PLAYING_RULES_OUT_FILE}"
+
+          echo "Pandoc output written to ${OUT_DIR}/${PLAYING_RULES_OUT_FILE}"
+
       - name: Zip offline site
         run: |
           set -euo pipefail
           cd "${RUNNER_TEMP}/mkdocs_out/site_offline/"
           zip -r "${GITHUB_REF_NAME}.zip" ./${GITHUB_REF_NAME}
 
+      - name: Prepare release notes
+        run: |
+          set -euo pipefail
+
+          RELEASE_NOTES="${RUNNER_TEMP}/release-notes.md"
+
+          if [[ "${GITHUB_REF_NAME}" == draft* || "${GITHUB_REF_NAME}" == rc* ]]; then
+            printf 'Prerelease.\n\n' > "${RELEASE_NOTES}"
+          else
+            : > "${RELEASE_NOTES}"
+          fi
+
+          cat docs/summary-of-changes.md >> "${RELEASE_NOTES}"
+
       - name: Publish prerelease
         if: startsWith(github.ref_name, 'rc') || startsWith(github.ref_name, 'draft')
         uses: softprops/action-gh-release@v2
@@ -107,11 +147,11 @@ jobs:
           prerelease: true
           name: ${{ github.ref_name }}
           tag_name: ${{ github.ref_name }}
-          body: |
-            Prerelease.
+          body_path: ${{ runner.temp }}/release-notes.md
           files: |
             ${{ runner.temp }}/mkdocs_out/site_offline/${{ github.ref_name }}.zip
             ${{ runner.temp }}/pandoc/${{ github.ref_name }}-${{ env.SHORT_SHA }}.docx
+            ${{ runner.temp }}/pandoc/${{ github.ref_name }}-${{ env.SHORT_SHA }}-playing-rules.docx
 
       - name: Publish release
         if: startsWith(github.ref_name, 'v')
@@ -119,8 +159,11 @@ jobs:
         with:
           name: ${{ github.ref_name }}
           tag_name: ${{ github.ref_name }}
+          body_path: ${{ runner.temp }}/release-notes.md
           files: |
             ${{ runner.temp }}/mkdocs_out/site_offline/${{ github.ref_name }}.zip
+            ${{ runner.temp }}/pandoc/${{ github.ref_name }}-${{ env.SHORT_SHA }}.docx
+            ${{ runner.temp }}/pandoc/${{ github.ref_name }}-${{ env.SHORT_SHA }}-playing-rules.docx
 
       - name: Checkout gh-pages branch
         uses: actions/checkout@v4
@@ -168,4 +211,4 @@ jobs:
           git config user.name "github-actions[bot]"
           git config user.email "github-actions[bot]@users.noreply.github.com"
           git commit -m "Deploy draft preview ${GITHUB_REF_NAME}" || echo "No changes to commit"
-          git push origin gh-pages
+          git push origin gh-pages

.gitignore

@@ -15,4 +15,8 @@
 
 # Tempfiles created by git-spell-check
 docs-dictionary-*
-temp_file-*
+temp_file-*
+
+# Local AI working files live here. Keep ignored on non-ai branches.
+.ai/
+AGENTS.md

README.md

@@ -1,27 +1,101 @@
 <p align="center">
-<img src="docs/assets/cmba-logo.svg" width="200">
+  <img src="docs/assets/cmba-logo.svg" width="200" alt="CMBA logo">
 </p>
 
-# CMBA Bylaws, Policies, and Playing rules
+# CMBA Bylaws, Policy, and Playing Rules
 
-The Constitution and Bylaws for the baseball league known as the [Chicago Metropolitan Baseball Association (CMBA)](#about-the-cmba).
+This repository contains the governing documents for the Chicago Metropolitan Baseball Association (CMBA) in Markdown form, along with the MkDocs configuration used to publish them as a static documentation site.
 
-The source text for this document can be found in Markdown format in [src/cmba-bylaws.md](src/cmba-bylaws.md).
+## Repository Layout
 
-## Building from source
+- `docs/index.md`: site home page
+- `docs/01-bylaws.md`: league bylaws
+- `docs/02-policy.md`: league policy
+- `docs/03-playing-rules.md`: playing rules
+- `mkdocs/mkdocs.yml`: MkDocs site configuration
+- `mkdocs/requirements.txt`: Python packages required to build the site
+- `tools/build.sh`: production build script
+- `tools/spellcheck/`: CSpell configuration and custom baseball dictionary
+
+## Local Development
 
 ### Requirements
 
-### Steps
+- Python 3
+- `pip`
 
-## Project history
+### Install Dependencies
 
-The constitution and bylaws were modernized in 2021, using Google Docs. This project brings that effort into Git and Github. Previous commits show a generated plain-text history of the changes prior to this project (thanks to [gitdriver](https://github.com/larsks/gitdriver)), with the first being the version from 2016.
+```bash
+python3 -m pip install -r mkdocs/requirements.txt
+```
 
-## Spell-checking
+### Preview the Site Locally
 
-## GitHub Pages
+```bash
+mkdocs serve -f mkdocs/mkdocs.yml
+```
+
+MkDocs serves the site locally and watches the Markdown files under `docs/` for changes.
+
+## Editing Guidance
+
+- Keep the canonical text in the Markdown files under `docs/`.
+- Preserve the separation between bylaws, policy, and playing rules.
+- Use the local preview server when editing headings, internal links, or cross-references.
+- Update `tools/spellcheck/baseball-words.txt` when league-specific terminology is flagged by CSpell.
+
+## Amendment Flow
+
+Amendments move through three review stages before publication:
+
+1. Draft amendments are prepared on the `draft` branch. Use this branch for active editing, internal review, and early validation.
+2. Drafts may be prereleased for review by pushing a `draft*` tag. The draft prerelease provides a reviewable GitHub release and deploys the draft preview site at `/draft/`.
+3. When the draft is ready for formal consideration, merge it into `release-candidate` with a merge commit. The merge commit preserves the point at which the draft moved into release-candidate review.
+4. Release candidates may be prereleased for review by pushing an `rc*` tag. The release-candidate prerelease provides the version to be voted on and deploys the release-candidate preview site at `/rc/`.
+5. After the amendment is voted on and approved according to the required CMBA process, merge the release candidate into `main`.
+6. Publish the approved amendment from `main` by pushing a `v*` tag and creating the final GitHub release.
+
+The final GitHub release is the published record for an approved amendment. It should include:
+
+- an offline HTML version of the documents
+- a `.docx` version of the combined bylaws, policy, and playing rules
+- a `.docx` version of the playing rules only
+
+## Publishing
+
+Publishing is driven by GitHub Actions.
+
+### `ci-docs`
+
+The `.github/workflows/ci-docs.yml` workflow runs on pushes to `main`, `draft`, and `release-candidate`, and can also be started manually.
+
+It performs the non-publishing validation steps:
+
+- spellchecks `docs/**/*.md` and `README.md` with CSpell
+- installs the MkDocs dependencies from `mkdocs/requirements.txt`
+- runs a MkDocs build using `mkdocs/mkdocs.yml`
+
+### `release`
+
+The `.github/workflows/release.yml` workflow runs on pushed tags matching `draft*`, `rc*`, and `v*`, and can also be started manually.
+
+It builds both the normal site and an offline site package, then publishes based on the tag prefix:
+
+- `draft*`: creates a GitHub prerelease, attaches the offline zip and generated `.docx`, and deploys the preview site to the `gh-pages` branch under `/draft/`
+- `rc*`: creates a GitHub prerelease, attaches the offline zip and generated `.docx`, and deploys the preview site to the `gh-pages` branch under `/rc/`
+- `v*`: creates a GitHub release, attaches the release artifacts, and deploys the release site to the root of the `gh-pages` branch
+
+The GitHub release description is generated from `docs/summary-of-changes.md`. Draft and release-candidate prereleases prepend a short prerelease note before that summary.
+
+In all cases, the release workflow uses the same MkDocs configuration in `mkdocs/mkdocs.yml`, with strict mode controlled by the `MKDOCS_STRICT` GitHub Actions variable.
+
+## Project History
+
+The constitution and bylaws were re-architected in 2026 into the CMBA Bylaws, Policy, and Playing Rules.
+
+The constitution and bylaws were modernized in 2021 using Google Docs. This project brings that work into Git and GitHub. Earlier commits preserve generated plain-text history of prior revisions, with the earliest tracked version dating to 2016.
 
 ## About the CMBA
-This baseball league known as the [Chicago Metropolitan Baseball Association (CMBA)](http://cmbabaseball.com) has been formed for the purpose of providing the finest amateur baseball league in the State of Illinois and Midwest; a league where an up and coming young prospect for professional baseball may play and develop; where the talented veteran player can enjoy playing among the best competition; and bring friendship and sportsmanship to the Association.
 
+The [Chicago Metropolitan Baseball Association](http://cmbabaseball.com) exists to provide a high-level amateur baseball league in Illinois and the Midwest, where developing players and veteran players can compete in a strong environment centered on baseball, sportsmanship, and community.

docs/01-bylaws.md

@@ -1,7 +1,7 @@
 # League Bylaws
 
 ## Name
-The name of the corporation as incorporated and existing under and by virtue of the Illinois General Not for Profit Corporation Act of 1986, as amended ("the Act") shall be the Chicago Metropolitan Baseball League (the "League"). The League shall have powers as are now or as may hereafter be granted by the Act.
+The name of the corporation as incorporated and existing under and by virtue of the Illinois General Not for Profit Corporation Act of 1986, as amended ("the Act") shall be the Chicago Metropolitan Baseball Association (the "League"). The League shall have powers as are now or as may hereafter be granted by the Act.
 
 ## Purpose
 This League is organized exclusively for such social and athletic purposes as will qualify under Illinois statute for a non-profit corporation. It has been formed for the purpose of serving its member franchises ("Member Franchises") by organizing the finest amateur baseball league in the State of Illinois and Midwest; a league where an up and coming young prospect for professional baseball may play and develop; where the talented veteran player can enjoy playing among the best competition; and bring friendship and sportsmanship to the League and its community.
@@ -57,13 +57,13 @@ The Commissioner shall
 1. Preside at meetings of the Membership and of the Board of Directors.
 1. Execute contracts in the name of and on behalf of the League, with approval of the board or in accordance with the budget approved by the Board.
 1. Prepare and propose the League’s budget for approval by the Board.
-1. Shall perform such other duties as may be determined by the Board of Directors, and shall perform and discharge such other duties as generally devolve upon a chief executive officer.
+1. Perform such other duties as may be determined by the Board of Directors, and shall perform and discharge such other duties as generally devolve upon a chief executive officer.
 
 ### Treasurer
 The Treasurer shall keep or, at the discretion of the Board cause to be kept, correct and complete records showing accurately at all times the financial condition of League; shall be legal custodian of all monies and other valuables which may from time to time come into the possession of the League; shall maintain a bank account in the name of League; shall prepare and file or, at the discretion of the board, cause to be prepared and filed, all required corporation tax forms and reports; shall furnish at meetings of the Board of Directors and Membership or whenever requested by the Board of Directors, a statement of the financial condition of the League; shall maintain or, at the discretion of the Board, cause to be maintained a roster of active Members in Good Standing; and shall perform such other duties as the Board of Directors may prescribe.
 
 ### Secretary
-The Secretary shall have the custody and care of the corporate records of the League, shall attend all meetings of the Members and of the Board of Directors, shall keep a true and complete record of the proceedings of all such meetings, shall file and take charge of all documents belonging to the League, and shall perform such duties as may be prescribed by the Board of Directors.
+The Secretary shall have the custody and care of the corporate records of the League, shall attend all meetings of the Members and of the Board of Directors, shall keep a true and complete record of the proceedings of all such meetings, shall file and take charge of all documents belonging to the League, and shall perform such duties as may be prescribed by the Board of Directors. In the absence or incapacity of the Commissioner, the Secretary shall perform the duties of the Commissioner.
 
 ### Compensation
 The Officers shall serve without compensation.
@@ -109,8 +109,10 @@ Each Member Franchise in good standing shall be entitled to one vote on matters
 Member actions shall include:
 1. Election of Directors;
 2. Advisory votes on League operational matters submitted for membership input;
-3. Confidence votes on League Officers.
-4. Approval of amendents to the Playing Rules.
+3. Confidence votes on League Officers;
+4. Approval of amendments to the Playing Rules. 
+
+Typographical corrections, formatting changes, cross-reference updates, and other non-substantive changes that do not alter the meaning or effect of a Playing Rule shall not constitute amendments requiring approval by Member Franchises.
 
 Unless otherwise required by these Bylaws, member actions shall be decided by a simple majority of votes cast at a meeting at which a quorum is present.
 
@@ -130,4 +132,4 @@ The League shall keep correct and complete books and records of accounts and als
 These Bylaws may be altered, amended, or repealed, and new bylaws may be adopted by resolution of the Board of Directors at any time or from time to time by the vote of two-thirds of the Directors.
 
 ## Dissolution 
-Upon dissolution of the League or the winding up of its affairs, the League's Board of Directors shall, after paying or making provisions for the payment of all the liabilities of the League, dispose of all the assets of the League exclusively for the purposes of the League in such manner, or to such organization or organizations organized and operated exclusively for charitable, educational, religious, or scientific purposes as shall at the time qualify as an exempt organization or organizations under Section 501(c)(3) of the Code, or any corresponding section of any future federal tax code, as the Board of Directors shall determine. Any such assets not so disposed of shall be distributed to the federal government, or to a state or local government for a public purpose.
+Upon dissolution of the League or the winding up of its affairs, the Board of Directors shall, after paying or making provision for the payment of all liabilities of the League, distribute the remaining assets of the League in a manner consistent with the purposes of the League and applicable law. The Board may distribute such assets to one or more nonprofit, amateur athletic, community, or other lawful organizations whose purposes are consistent with those of the League, or as otherwise permitted or required by law. Any such assets not so disposed of shall be distributed to the federal government, or to a state or local government for a public purpose.

docs/02-policy.md

@@ -68,8 +68,7 @@ Amendments to the Bylaws are governed exclusively by the procedures set forth th
 
 ### Playing Rules Amendments
 1. Playing Rules governing on-field competition may be amended separately from this League Policy.
-1. Playing Rules amendments shall be adopted by a vote of Member Franchises in Good Standing.
-1. Unless otherwise specified, a simple majority vote shall be sufficient to adopt a Playing Rules amendment.
+1. Playing Rules amendments may be proposed by the Commissioner or Board and shall be approved by a vote of Member Franchises in Good Standing in accordance with the Bylaws. Member Franchises may submit amendments to the Commissioner or Board for proposal at the Commissioner's or Board's discretion.
 1. Playing Rules amendments shall not apply retroactively and shall take effect at the start of a season.
 
 ## League Participants
@@ -94,10 +93,10 @@ All references to “Teams” within this document shall be deemed synonymous wi
 1. The league reserves the right to reject, revoke, or require modification of any team name for any reason, including but not limited to offensiveness, duplication, or reputational concerns.
 
 ####  Admission of New Member Franchises
-The Commissioner shall review applications for new Member Franchises for compliance with Franchise Standards.
+The Commissioner shall review applications for new Member Franchises for compliance with Franchise standards.
 
 1. Upon acceptable review, the Commissioner shall present the proposed Member Franchise to the League membership for consideration.
-1. Proposed Member Franchises may present a positive case for inclusion.
+1. Candidate Member Franchises may present a positive case for inclusion.
 1. Acceptance shall require a simple majority vote of the Board.
 
 #### Manager Designation and Authority
@@ -188,7 +187,7 @@ Tampering, or poaching, is defined as the deliberate solicitation, without conse
 Member Franchises are expected to prioritize their commitments to the League. Participation in outside leagues is permitted by agreement with the League. Participation in outside leagues does not relieve a Member Franchise or its Players of League obligations, including playing games on their League-scheduled dates and times. Violations of this provision may result in disciplinary action.
 
 ### Penalties and Fees
-The Commissioner may levy fines to any League Member franchise or player subject to Board oversight. Fines may be levied for violation of Bylaws or Policies or conduct unbecoming of a representative of the League. The penalties and amounts set forth in this section are operational in nature and may be adjusted by the Commissioner with Board oversight, unless otherwise specified. 
+The Commissioner may levy fines to any Member Franchise or player subject to Board oversight. Fines may be levied for violation of Bylaws or Policies or conduct unbecoming of a representative of the League. The penalties and amounts set forth in this section are operational in nature and may be adjusted by the Commissioner with Board oversight, unless otherwise specified. 
 
 1. Late payment of annual dues shall incur a penalty of ten dollars ($10.00) per week, not to exceed five (5) weeks.
 1. Members in violation of the above shall be placed on temporary suspension for a period of two (2) weeks.
@@ -202,7 +201,7 @@ The Commissioner may levy fines to any League Member franchise or player subject
 1. A Manager aggrieved by a discretionary or judgment decision of the Commissioner may request Board review within seventy-two (72) hours of the decision; the Board may, in its sole discretion, accept or decline review, and if it accepts review, it may affirm, modify, or reverse the Commissioner's decision by majority vote. The Board is not required to hold a hearing or provide a written explanation when declining review, and unless the Board grants a stay, the Commissioner's decision remains in effect pending Board review.  Decisions on appeal or Board review are final.
 
 ## Annual League Meeting
-The League shall hold an annual meeting in according with the Bylaws. Quorum and voting thresholds are governed by the Bylaws. The annual meeting process shall consist of the following stages:
+The League shall hold an annual meeting in accordance with the Bylaws. Quorum and voting thresholds are governed by the Bylaws. The annual meeting process shall consist of the following stages:
 
 ### Pre-Meeting of the Current Board
 Prior to the annual meeting, the current Board shall convene to prepare and approve the proposed agenda, voting items, and supporting materials for member review.
@@ -228,7 +227,7 @@ Following the annual meeting, the newly constituted Board shall convene to:
 1. Approve or reject new Member Franchises;
 1. Assign committees, roles, and implementation responsibilities for the upcoming season.
 
-This shall constitute the Board's annual meeting requirements as required by the Bylaws
+This shall constitute the Board's annual meeting requirements as required by the Bylaws.
 
 ## Conduct and Discipline
 
@@ -307,7 +306,7 @@ Prior to June 1, each team has an “open roster.”  League teams must submit a
 Each team’s roster must contain a minimum of sixteen (16) players and shall not exceed twenty-six (26) players, in each case, excluding non-playing Managers and coaches. 
 
 #### Roster Information Requirements
-A team’s rosters as submitted to the Commissioner on or before June 1 shall contain the following information for each rostered player: name, age, bats/throws, position(s),uniform number, and face photo. Rosters shall be submitted in Excel or via Google sheets (or similar editable spreadsheet.)
+A team’s rosters as submitted to the Commissioner on or before June 1 shall contain the following information for each rostered player: name, age, bats/throws, position(s), and uniform number. Rosters shall be submitted in Excel or via Google sheets (or similar).
 
 #### Roster Transactions
 Teams may add a total of five (5) players to the roster after the June 1 roster submission deadline. The total number of players on a team still may not exceed twenty-six (26). In order to add players between June 1 and July 1 but not exceed the 26 player limit, a team may drop players who were rostered on June 1.  No players may be added after July 1, except as set forth below.
@@ -325,7 +324,7 @@ Eligible players must be of at least eighteen (18) years of age by the date of t
 A team that uses an ineligible player, per the rules in this [Team Rosters Players And Eligibility](#team-rosters-players-and-eligibility), will be deemed to have forfeited any and all games in which the illegal player(s) participated.
 
 #### Free Agents
-A player must inform the League Commissioner and such player's Manager no later than February 15 of the upcoming season if of an intention to leave the team and become a free agent. After this the player is free to play for another team in the League. A Manager may waive this deadline for an individual player at the Manager’s discretion. If the player fails to notify as specified, that player shall be disqualified from playing on another League team for that season.
+A player must inform the League Commissioner and such player's Manager no later than February 15 of the upcoming season of their intention to leave the team and become a free agent. After this the player is free to play for another team in the League. A Manager may waive this deadline for an individual player at the Manager’s discretion. If the player fails to notify as specified, that player shall be disqualified from playing on another League team for that season.
 
 ### Uncompleted Games
 All games not completed by the end of the regular season shall count as losses for both teams unless a team deliberately attempts to avoid playing a sanctioned game. The team that was willing to play the game will be judged the forfeit winner if so ruled by the Commissioner.
@@ -343,7 +342,7 @@ The League shall use a point system to determine the standings. A team is awarde
 In the event two teams finish the regular season in a tie for a position, the following tie-breaking procedure will take effect:
 
 1. Win-Loss Record in head-to-head competition.
-1. Win-Loss Record within the league.
+1. Win-Loss Record within the League.
 1. Win-Loss Record within the division (if applicable).
 1. Least runs allowed for the season.
 1. Coin toss, performed by the Commissioner with a witness.
@@ -371,7 +370,7 @@ All postseason games shall use the Restricted Lineup Format, as defined in the P
 
 All playoff games must be played to completion. If a postseason game is duly called by the umpire for any reason, the game is considered suspended. The game will be continued from the point in the game when it was suspended at a later date provided by the Commissioner. Lineup changes shall be subject to the Playing Rules governing substitution.
 
-The run-rule, or“Slaughter Rule”, is applicable in postseason play.
+The run-rule, or “Slaughter Rule”, is applicable in postseason play.
 
 ## Game Administration
 ### Subjectivity
@@ -411,7 +410,7 @@ Unless otherwise supplied, the home team must supply two (2) and the visitors on
 All bats must be wood or BBCOR certified. Use of an illegal bat shall be subject to the Major League rules that govern this area.
 
 #### Bases, home plate, and pitching rubber  
-All teams are expected to have a set of bases, a home plate, and a pitching rubber. These items shall conform to Major League Baseball specifications. Items conforming to 2022 specifications shall also be considered legal.
+All teams are expected to have a set of bases, a home plate, and a pitching rubber. These items shall conform to applicable Playing Rules.
 
 The host team for the field shall be responsible for accurately setting up the bases, and if necessary, home plate and the pitching rubber. In the event neither team is host of the field, the home team shall have this responsibility. Should the responsible team fail to have these necessities by the start of the game, they will lose by forfeit. The visiting team may lend the equipment, although they are not required to do so.
 
@@ -419,7 +418,7 @@ The host team for the field shall be responsible for accurately setting up the b
 Uniform compliance is required in order to protect League competitive integrity, roster transparency, and game administration. 
 
 1. Required uniform elements are:
-      1. Team jersey bearing the team identity;
+      1. Team jersey and cap bearing the team identity;
       1. A unique uniform number assigned to that Player;
       1. Baseball pants.
 1. A Player may not wear or borrow another rostered Player’s jersey or number to satisfy this rule.
@@ -451,7 +450,7 @@ Protests may only be made on the grounds of a violation of a rule stated in Leag
 All teams are responsible for the maintenance and cleanup of the field and dugout areas after a game. Both teams must fill in all infield, batter’s box, and pitching mound holes. Additionally, both teams must have adequate equipment on hand for field maintenance. Teams who repeatedly fail to do proper post-game maintenance may be subject to discipline.
 
 #### Notification of Results
-The winning team shall be responsible for notifying the Commissioner of the score of the game no later than 10:00 AM the day after the game was played via text message, email, or telephone call. In the result of a forfeit, notification shall be immediately at the conclusion of the game.
+The winning team shall be responsible for notifying the Commissioner of the score of the game no later than 10:00 AM the day after the game was played via text message, email, or telephone call. In the event of a forfeit, notification shall be immediately at the conclusion of the game.
 
 #### Notification of Protest
 Managers shall notify the league Commissioner of any formal [Protest](#protests) at the earliest possible time after the game and provide umpire signature as proof of notification.
@@ -476,7 +475,7 @@ The opponent of a team in technical forfeit is entitled to a full (2) standings
 #### Forfeit
 If a game is forfeited, the following applies:
 
-1. The forfeiting team must pay, at the time of the forfeit, the full cost of the umpire(s), and shall be considered not in Good Standing. Teams will be considered not in Good Standing until payment is made.
+1. The forfeiting team shall be considered not in Good Standing. Teams will be considered not in Good Standing until payment is made.
 1. The forfeiting team shall receive a loss and a minus two (-2) point standings penalty.
 1. The non-forfeiting team shall receive a 7 runs to 0 runs win in the standings and is entitled to a full (2) standings points.
 1. The forfeiting team must pay the full cost of umpire fees for the forfeited game.

docs/03-playing-rules.md

@@ -15,11 +15,22 @@ These rules shall *not* incorporate the following rules of Major League Baseball
 - Rule(s) requiring that pitchers must face at least three batters.
 - Rule(s) specifying time limits on pitchers and batters. 
 - Rule(s) limiting pitcher disengagements (i.e. pick-offs).
+- Rule(s) enlarging bases from 15 inches square to 18 inches square. Either base size is acceptable as long as each base used in the game are the same size.
 - Any rule requiring specialized equipment or trained personnel, such as replay review.
 
 ## Pre-Game Meeting
 Before first pitch, the Managers and the umpire-in-chief shall conduct a pre-game meeting. A Manager may designate a team delegate to attend on the Manager’s behalf. At this meeting, the teams shall exchange lineups and review any applicable ground rules with the umpire.
 
+## Pre-Game Warmups
+As a general pre-game guideline, teams should plan for about 20 to 30 minutes of total defensive warmup time (i.e. an infield/outfield routine), counted from when the first team starts, and distributed evenly as practically as possible. The visiting team will usually go first, and the home team will usually take the final turn before the pre-game meeting and first pitch. For fields where a batting cage is available, the team not using the field should make use of the batting cage while the other team finishes its defensive warmups.
+
+Managers may agree to reverse the order or adjust the timing if that works better for both teams.
+
+!!! Examples
+      For a game starting at 9:30 am at a field with a batting cage, the visiting team might perform their infield/outfield routine from about 9:00 to 9:15 while the home team uses the batting cage. The teams would then switch, with the home team taking the field from about 9:15 to 9:30 and the visiting team using the cage or bullpen until first pitch.
+
+      For a game starting at 6:15 pm at a field with a batting cage, the home team might start offensive warmups in the batting cage at 6:00 pm. Because there are 15 minutes before first pitch, they take approximately 7.5 minutes for offensive warmups while the visiting team uses the field for their defensive infield/outfield routine. The teams would then switch, with the home team taking the field from about 6:07 to 6:14 and the visiting team using the cage until first pitch.
+
 ## Regulation Games
 Games played under the auspices of both recognized Managers of the participating teams shall count as official. A regulation game is defined as follows
 
@@ -56,7 +67,7 @@ In the Expanded Lineup Format, a team’s batting lineup shall constitute not fe
 
 A player substituted from the batting order may not re-enter the batting order unless otherwise permitted herein. Defensive substitutions may be made freely at any time and do not affect the batting order. Players may enter, exit, and re-enter defensively without limitation.
 
-The following lineup designations are permitted, but not required, in Expanded Lineup Format:
+The following lineup designations are permitted, but not required, in the Expanded Lineup Format:
 
 - Any number of Extra Hitters
 - (1) Designated Runner
@@ -65,7 +76,7 @@ The following lineup designations are permitted, but not required, in Expanded L
 !!! Note
       A player occupying the Extra Hitter position may assume any defensive position at any time without affecting the batting order. Likewise, a player currently in the defensive alignment may be reassigned to the Extra Hitter position without affecting the batting order. In the Expanded Lineup Format, changes in defensive alignment do not alter the order or occupancy of batting positions.
       
-      Because defensive alignment does not govern the batting order in the Expanded Lineup Format, the Designated Hitter designation does apply in Expanded Lineup Format. Any player marked as a DH will be considered an error and assumed to be an EH.
+      Because defensive alignment does not govern the batting order in the Expanded Lineup Format, the Designated Hitter designation does not apply in Expanded Lineup Format. Any player marked as a DH will be considered a mistake and assumed to be an EH.
 
 #### Shared Batting Positions
 In the Expanded Lineup Format, any batting position may be designated at lineup exchange as shared by two players (“A” and “B”). The two players shall bat in alternating sequence each time that position appears in the order, beginning with the player designated “A.”
@@ -93,18 +104,21 @@ The following lineup designations are permitted, but not required, in Restricted
 ### Minimum Number of Players
 The minimum number of players per team shall be established as the number of required batting positions as governed by the applicable Lineup Format.
 
-Teams may play with (1) fewer player and if each team has at least this many players present, they must start the game. 
-
-League Policy may apply standings penalty for teams that start with fewer than the minimum.  League Policy may also designate a "forfeit time," the period after which a team with less than the minimum is subject to penalty. A team may not wait until this forfeit time for players to arrive. A team may insert a player into the vacant spot after the start of play.
-
-Any unoccupied patting positions are shall be recorded as an out each time it appears in the batting order unless otherwise provided in these Rules, or League Policy. 
-
-A team may finish the game (1) player short, that is one (1) player less than they started the game with (eight (8) players for a nine (9) person line-up, nine (9) players for a ten (10) person lineup). Should a team fall below (8) players, the game is terminated and this team loses by forfeit.
+Teams may play with one (1) fewer player, and if each team has at least this many players present, they must start the game.
 
 !!! Note "Example" 
       For a game subject to the Expanded Lineup, the required number of batting positions is nine (9), so as soon as each team has eight (8) players, the game must start. 
 
-      If a team starts with (8) the vacant ninth spot is an automatic out each time it comes up. If the ninth player arrives after first pitch, that player may be inserted into the vacant spot.
+League Policy may apply standings penalty for teams that start with fewer than the minimum.  League Policy may also designate a "forfeit time," the period after which a team with less than the minimum is subject to penalty. A team may not wait until this forfeit time for players to arrive. A team may insert a player into the vacant spot after the start of play.
+
+Any unoccupied batting positions shall be recorded as an out each time it appears in the batting order unless otherwise provided in these Rules, or League Policy. 
+
+A team may finish the game (1) player short, that is one (1) player less than they started the game with (eight (8) players for a nine (9) person line-up, nine (9) players for a ten (10) person lineup). Should a team fall below eight (8) players, the game is terminated and this team loses by forfeit.
+
+!!! Note "Example" 
+      For a game subject to the Expanded Lineup, the required number of batting positions is nine (9). If a team starts with eight (8) the vacant ninth spot is an automatic out each time it comes up. If the ninth player arrives after first pitch, that player may be inserted into the vacant spot. 
+      
+      If a team drops below 8 players, that team will lose by forfeit.
 
 
 ### Lineup Designations
@@ -113,10 +127,10 @@ A Designated Hitter may bat for any defensive player. If the defensive player fo
 
 #### Extra Hitter (EH)
 
-An Extra Hitter is a batting-only lineup position and may not be used in the field as an extra defensive fielder. For substitution and lineup-administration purposes, an EH position shall be treated the same as a defensive position and may be substituted, re-entered, or reassigned in as governed by the applicable Lineup Format.
+An Extra Hitter is a batting-only lineup position and may not be used in the field as an extra defensive fielder. For substitution and lineup-administration purposes, an EH position shall be treated the same as a defensive position and may be substituted, re-entered, or reassigned as governed by the applicable Lineup Format.
 
 #### Designated Runner (DR)
-A Designated Runner may run for a specified batting position whenever the player occupying that batting position safely reaches base. If the defensive player for whom the DR bats enters the batting order, the DR is terminated. Substitution of either player is governed by the applicable Lineup Format.
+A Designated Runner may run for a specified batting position whenever the player occupying that batting position safely reaches base. The DR may be substituted into the batting order at any batting position. Once the player designated as DR enters the batting lineup, the player is no longer considered a designated runner and may no longer run for the previously assigned batting position. Substitution of either player is governed by the applicable Lineup Format.
 
 Teams with no eligible players remaining on the bench (i.e. all players are in the batting lineup) may elect to use the player that made the last out as the designated runner.
 
@@ -132,7 +146,7 @@ Substitutions are governed by the applicable Lineup Format with the following ex
 
 Should a player suffer a debilitating injury during the game and cannot continue, and a team has no more eligible players on its bench, a team can use a player that was removed from the game to replace him. This replacement player must be the first player removed from the game, and if this player is unavailable the next player is used (and so on). If no reserve is present, the vacated spot in the lineup is skipped and all batters move up accordingly, with no penalty to the affected team.
 
-If a substantial case can be made that a team skipped a spot with the intent to gain a competitive advantage, the pending team may be subject to penalty, up to and including forfeit following a successful protest in accordance with League Policy.
+If a substantial case can be made that a team skipped a spot with the intent to gain a competitive advantage, the offending team may be subject to penalty, up to and including forfeit following a successful protest in accordance with League Policy.
 
 ## Collisions
 Collisions are prohibited, except for contact that results from a legal slide. The runner is responsible for sliding or otherwise avoiding contact. Fielders and runners must comply with Incorporated Rules governing interference, obstruction, and collisions at home plate.
@@ -140,8 +154,8 @@ Collisions are prohibited, except for contact that results from a legal slide. T
 Unless the umpire rules that the contact was incidental or caused by fielder obstruction, the runner shall be called out, the ball declared dead, and the runner automatically ejected. If the umpire determines the collision was flagrant, additional penalties may be imposed as applicable in League Policy.
 
 ## Umpire Disputes
- The appeal of umpire decisions shall be governed as set forth in the Incorporated Rules. Any protests must be made in accordance with League Policy.
+The appeal of umpire decisions shall be governed as set forth in the Incorporated Rules. Any protests must be made in accordance with League Policy.
 
 !!! Note "Generally"
-      - Any umpire’s decision which involves judgment are final. No player or manager shall object to any such judgment decisions. 
-      - If there is reasonable doubt that any umpire’s decision may be in conflict with the rules, the Manager, and the Manger alone, may appeal the decision and ask that a correct ruling be made. 
+      - Any umpire’s decision which involves judgment is final. No player or manager shall object to any such judgment decisions. 
+      - If there is reasonable doubt that any umpire’s decision may be in conflict with the rules, the Manager, and the Manager alone, may appeal the decision and ask that a correct ruling be made. 

docs/index.md

@@ -1 +1,38 @@
+<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.
+
+## Additional Resources
+
+- [Summary of Changes](summary-of-changes.md)

docs/summary-of-changes.md

@@ -0,0 +1,35 @@
+# High-Level Summary of Changes
+
+### Governance
+
+- The League has moved from a President-centered governance model to a Board-led nonprofit governance model.
+- The old life-term President structure has been replaced by annually elected Directors and annually appointed Officers.
+- The Board now has formal authority over corporate governance, League Policy, officer appointments, budgets, membership status, and oversight of the Commissioner.
+- The Commissioner remains responsible for day-to-day League administration, but now operates under Board oversight and an approved budget.
+- Member Franchises retain an important voice: they elect Directors, vote on Playing Rules amendments, give advisory votes on operations, and participate in confidence votes on Officers.
+- The current draft clarifies that Bylaws, League Policy, and Playing Rules are separate documents with different amendment processes.
+- The League's legal/corporate framework has been modernized to include nonprofit powers, limitations, records, deposits, registered office/agent, and dissolution provisions.
+
+### League Policy
+
+- Operational rules have been moved into a dedicated League Policy document instead of being mixed throughout the old Constitution, By-Laws, and Playing Rules.
+- Member Franchises, Managers, Players, Good Standing, suspension, discipline, appeals, annual meetings, rosters, postseason eligibility, field administration, uniforms, forfeits, and standings are now organized in one policy document.
+- The Manager is now clearly identified as the sole authorized representative of a Member Franchise unless the Commissioner approves otherwise.
+- Good Standing is more clearly tied to financial obligations, compliance, voting rights, postseason eligibility, and League awards.
+- Discipline is more structured: the Commissioner may impose discipline, the Board provides oversight, committees are advisory unless specifically given authority, and appeals/Board review are defined.
+- Conduct rules have been strengthened around professionalism, fighting, umpire abuse, dangerous play, alcohol, facility rules, false reporting, and repeated noncompliance.
+- Roster administration remains familiar but has been cleaned up. The latest draft removes the face-photo roster requirement and allows roster submission through Excel, Google Sheets, or similar formats.
+- Forfeits, technical forfeits, standings points, postseason eligibility, field status, rescheduling, protests, and reporting obligations are now more clearly separated from Playing Rules.
+
+### Playing Rules
+
+- Playing Rules now focus on on-field competition only, with administrative topics moved into League Policy.
+- Pre-game warmup guidance has been added for  field sharing, batting cage use, and a suggested 20-to-30-minute overall warmup window counted from when the first team starts.
+- The Playing Rules expressly incorporate the Official Baseball Rules unless a League exception applies.
+- The draft clarifies which modern MLB rules are not adopted by description, including limits on position-player pitching, shift restrictions, extra-inning automatic runners, pitch clocks, disengagement limits, the three-batter minimum, per-game mound visit limits, mandatory 18-inch bases, and replay/specialized-equipment rules.
+- The League now has a clear rule hierarchy: League Policy controls first, then Playing Rules, then incorporated MLB rules.
+- Regular-season and postseason lineup rules are now organized as two formats: Expanded Lineup Format and Restricted Lineup Format.
+    - Regular-season flexibility is preserved through the Expanded Lineup Format, allowing unlimited Extra Hitters, shared batting positions, free defensive substitution, Designated Runners, and Courtesy Runners.
+    - Postseason play is treated more formally through the Restricted Lineup Format, which excludes shared batting positions and uses stricter substitution rules.
+- Minimum-player rules have been clarified: teams must start when both have one fewer than the required batting positions, short spots are outs, and teams falling below the minimum forfeit.
+- Collision, injury substitution, Designated Runner, Courtesy Runner, and umpire-dispute rules have been rewritten for clarity and consistency with incorporated baseball rules.

mkdocs/mkdocs.yml

@@ -1,4 +1,7 @@
 site_name: CMBA Bylaws, Policy, and Playing Rules
+site_url: !ENV [MKDOCS_SITE_URL, ""]
+repo_url: !ENV [MKDOCS_REPO_URL, ""]
+repo_name: !ENV [MKDOCS_REPO_NAME, ""]
 docs_dir: ../docs
 
 # Prevent accidental publishing of repo/CI/dev clutter

tools/spellcheck/cspell.yml

@@ -22,4 +22,5 @@ dictionaries:
 words:
   - cmba
   - chicagoland
-  - gitdriver
+  - gitdriver
+  - mkdocs