docs: overhaul README with structured file documentation

[Ash1421]

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]

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!

[rain-fade]

Beautifully organised and formatted.

[Patronics]

While this revised document is pretty, it's meaningless if it is fundamentally incorrect in the information it claims to provide. The folder structure it describes is pretty much entirely incorrect, presumably due to AI hallucinations. The PCB files are not Kicad files, they are Eagle files, and likewise every subfolder is completely incorrectly described, aside from the least important one, the images folder.

[rain-fade]

Damn, I always fall for the tell-tale bullet point slop.