Skip to content

Restructure README: video, collapsible sections, expanded docs#7

Merged
migus88 merged 2 commits into
mainfrom
docs/readme-mgenerators
May 27, 2026
Merged

Restructure README: video, collapsible sections, expanded docs#7
migus88 merged 2 commits into
mainfrom
docs/readme-mgenerators

Conversation

@migus88

@migus88 migus88 commented May 27, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Embed the YouTube tutorial (https://youtu.be/WSVPbAtFQCs) as a clickable thumbnail under the header.
  • Collapse install methods, attribute docs, and guidance into <details> blocks so the page reads as a TOC at a glance.
  • Add the missing [SingletonInclude] / [SingletonIgnore] section, document [Singleton]'s destroyOnLoad option, and add a "Generated members" table.
  • Move Swapping in tests and Lazy instantiation under a new ### Guidance subsection so they're no longer siblings of the attribute docs.
  • Add shields.io badges (OpenUPM, Unity, License), GitHub callouts, and --- separators to break up the wall of text.
  • Title is # MGenerators (matches main); bundle ID games.engine-room.generators is untouched.

Test plan

  • Open the PR on github.com and confirm the badges render in color and the YouTube thumbnail loads.
  • Expand each <details> block and check that code fences, tables, and > [!TIP] / > [!NOTE] / > [!WARNING] callouts render correctly.
  • Verify the Git URL install snippets (with and without #v1.0.0) actually resolve in Unity's Package Manager.
  • Sanity-check the OpenUPM scoped-registry instructions against a clean Unity project.

migus88 added 2 commits May 27, 2026 13:45
- Embed the YouTube tutorial as a clickable thumbnail under the header
- Collapsible install methods (OpenUPM CLI, Git URL with version pinning, manual scoped registry)
- Collapsible attribute docs with new section for [SingletonInclude] / [SingletonIgnore]
- Document [Singleton]'s destroyOnLoad flag and generated members
- Move "Swapping in tests" and "Lazy instantiation" under a Guidance subsection
- Add shields.io badges, GitHub callouts, and section separators for readability
GitHub renders [!NOTE]/[!TIP]/[!WARNING] callouts only at the markdown's
top level, not inside <details> blocks, so the two inside collapsibles
were falling through as plain quotes.
@migus88 migus88 merged commit 8d6f1a5 into main May 27, 2026
@migus88 migus88 deleted the docs/readme-mgenerators branch May 27, 2026 11:12
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.

1 participant