Skip to content

Extract Types/Ids/SerializeReferences references and rework READMEs#146

Draft
VPDPersonal wants to merge 13 commits into
mainfrom
docs/types-reference-overhaul
Draft

Extract Types/Ids/SerializeReferences references and rework READMEs#146
VPDPersonal wants to merge 13 commits into
mainfrom
docs/types-reference-overhaul

Conversation

@VPDPersonal

Copy link
Copy Markdown
Owner

Summary

  • 📝 Extract self-contained EN/RU references — Types.md, Ids.md, SerializeReferences.md — out of the oversized READMEs; drop the "— full reference" title suffix across all reference docs
  • 📝 Rework all four READMEs around the extracted references: new intro, polished TOC blurbs, the Serializable Type System section mirrored 1:1 against Types.md, sample callouts removed
  • 🖼️ New picker media: TypeSelectorDisplay/Required screenshots and an open-generic picking GIF; re-shot SerializableType / ComponentTypeSelector / picker-window shots
  • 🔧 DevTests DocsMedia harness (Game.Combat demo types) backing the screenshots, including GenericEffects for the open-generic GIF; sync-readmes skill updated

Notes for review

  • ⚠️ The picker's generic-argument page lists only [Serializable] candidates — the demo status effects carry the attribute for exactly that reason
  • 📝 The README's Serializable Type System section is intentionally a verbatim subset of Types.md (intro, full feature list, media), so future edits should land in Types.md first and be mirrored
🇷🇺 Описание на русском

Кратко

  • 📝 Полные справочники — Types.md, Ids.md, SerializeReferences.md (EN/RU) — вынесены из разросшихся README; у всех справочников снят суффикс «— full reference»
  • 📝 Все четыре README переработаны вокруг вынесенных справочников: новое интро, отполированное оглавление, раздел Serializable Type System зеркалит Types.md один в один, колауты сэмплов убраны
  • 🖼️ Новые медиа пикера: скриншоты TypeSelectorDisplay/Required и гифка выбора открытого generic; переcняты SerializableType / ComponentTypeSelector / окно пикера
  • 🔧 Обвязка DocsMedia в DevTests (демо-типы Game.Combat) для съёмки скриншотов, включая GenericEffects для generic-гифки; обновлён скилл sync-readmes

Заметки для ревью

  • ⚠️ Страница выбора generic-аргумента показывает только [Serializable]-кандидатов — демо-статус-эффекты несут атрибут именно поэтому
  • 📝 Раздел Serializable Type System в README — намеренно дословное подмножество Types.md: правки сначала в Types.md, затем зеркалить

VPDPersonal and others added 3 commits July 20, 2026 01:37
- add self-contained EN/RU references for the Serializable Type System, ID System and SerializeReference Selector, extracted from the READMEs
- drop the "— full reference" title suffix across all reference docs
- add picker media: TypeSelectorDisplay/Required screenshots, an open-generic picking GIF, re-shot SerializableType/ComponentTypeSelector/window shots

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SuJE65oWmemhK78zC7NfUq
- rewrite the intro and polish the TOC blurbs
- mirror the Serializable Type System section against Types.md: full TypeSelectorWindow feature list, Script-row note, generic-picking GIF
- replace the TypeSelectorAttribute mechanics paragraph with reference links; drop sample callouts

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SuJE65oWmemhK78zC7NfUq
- Game.Combat harness (Weapons, Loadout, CombatModifiers, WeaponMount, GenericEffects) backing the Types.md screenshots and the open-generic GIF
- update the sync-readmes skill

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SuJE65oWmemhK78zC7NfUq
@VPDPersonal VPDPersonal added type: documentation Documentation only status: work-in-progress Draft / not ready for review area: claude Claude Code automation (.claude/ skills, agents, hooks) area: docs Repository documentation (README, CHANGELOG, docs/) labels Jul 19, 2026
VPDPersonal and others added 10 commits July 20, 2026 01:59
- fix README count from fourteen/10-sample to sixteen/12-sample (SerializeReferences sample folder was missing)
- drop stale StringIdRegistry mention — the type no longer exists in the codebase

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Jf8Kdz9hobr77ckjYddJRn
…dates

- explain in the TypeSelectorWindow section (EN + RU) that the generic argument page only lists types Unity can serialize as a field value (primitives, enum, string, UnityEngine.Object refs, [Serializable] classes/structs)

Co-Authored-By: Claude <noreply@anthropic.com>
…overhaul

# Conflicts:
#	Aspid.FastTools/Packages/tech.aspid.fasttools/Documentation/EN/README.md
#	Aspid.FastTools/Packages/tech.aspid.fasttools/Documentation/RU/README.md
#	README.md
#	README_RU.md
- reword the [SerializeReference] example comment: picking a type creates
  an instance and assigns it to the field (no misleading "stores the type")
- explain Required = true inline: inspector warning plus build/CI-gate violation
- applied to all six synced copies (root/Documentation READMEs and Types.md, EN/RU)

Co-Authored-By: Claude <noreply@anthropic.com>
- add "Inspector type dropdown" media: picker GIF, missing-type repair
  and shared-reference Make unique notices
- add "Bulk repair tabs" screenshots: Asset References and Project References
- applied to both EN and RU copies

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Claude <noreply@anthropic.com>
- drop the Generators solution-structure tree and TypeData/IdStructData reference copies (ls and the sources show them)
- replace the Ids directory tree with a two-sentence layout summary keeping the non-obvious facts

Co-Authored-By: Claude <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area: claude Claude Code automation (.claude/ skills, agents, hooks) area: docs Repository documentation (README, CHANGELOG, docs/) status: work-in-progress Draft / not ready for review type: documentation Documentation only

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant