Skip to content

docs: overhaul README with structured file documentation#4

Open
Ash1421 wants to merge 3 commits intosb-ocr:mainfrom
Ash1421:improve/readme
Open

docs: overhaul README with structured file documentation#4
Ash1421 wants to merge 3 commits intosb-ocr:mainfrom
Ash1421:improve/readme

Conversation

@Ash1421
Copy link
Copy Markdown

@Ash1421 Ash1421 commented Apr 9, 2026

What this changes

Rewrites the README to make the repo easier to navigate for anyone who wants to build or remix the CM Deck.

Changes included

  • Centered header with logo, badges, and tagline
  • Clickable build video thumbnail (links to start of video)
  • Known PCB issues formatted as a table with video timestamps
  • Annotated repo structure tree explaining each folder and file
  • Dedicated sections for each major folder:
    • enclosure/STL/ — print settings table and parts overview
    • firmware/qmk/ — file descriptions, build and flash instructions
    • pcbs/ — what each board does and how to order Gerbers
    • boms/ — column reference for the CSV files
  • Build timeline table linking every chapter to its video timestamp
  • Cleaner license and credits section

Notes

File names in the repo tree are illustrative based on the visible folder structure. If anything is inaccurate, missing, or not quite right, please feel free to leave a comment and I'll get it updated!

@Ash1421
Copy link
Copy Markdown
Author

Ash1421 commented Apr 9, 2026

Hey Salim! 👋

Important

Please feel free to comment on this PR if you'd like anything added, removed, or changed before merging.

Note

The reason I put this together is because you seem like a genuinely cool person working on cool projects, and I'd love to help contribute where I can. If the style or approach isn't quite what you're looking for, I completely understand — no worries at all!

Copy link
Copy Markdown

@rain-fade rain-fade left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Beautifully organised and formatted.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants