Skip to content

Restore and update 'Anatomy of a YAML file' page and metadata reference - #646

Merged
nonprofittechy merged 2 commits into
mainfrom
restore-yaml-anatomy
Nov 5, 2026
Merged

nonprofittechy merged 2 commits into
mainfrom
restore-yaml-anatomy

Conversation

@nonprofittechy

Copy link
Copy Markdown
Member

Summary

  • Restores docs/authoring/weaver_code_anatomy.md (id: yaml_anatomy, slug: generated_yaml) and retitles it to Anatomy of a YAML file so it is easy to find in the Authoring interviews section.
  • Places Anatomy of a YAML file as the first item under Authoring interviews -> Customizing and extending interviews in sidebars.js and restores/adds links from related authoring and landing page guides.
  • Updates the block-by-block walkthrough and metadata reference to match current docassemble-ALWeaver output and production interviews:
    • Uses docassemble.AssemblyLine:assembly_line.yml in include: (noting al_package.yml as a legacy alias).
    • Documents allowed_courts, typical_role, al_weaver_version, and generated_on in metadata:.
    • Adds sections for AL_DEFAULT_COUNTRY / AL_DEFAULT_STATE, github_repo_name / github_user, template: interview_short_title, ALPeopleList objects:, multi-section navigation, copied Question Library (ql_baseline.yml) blocks, signature_fields, addresses_to_search, translatable bundle title templates, and overflow addendum configuration.
    • Documents both the default combined interview_order block and the separate interview_order / main_order pattern, as well as showifdef("users[0].address.zip") in store_variables_snapshot.
    • Notes id: alweaver assemblyline settings as an experimental feature currently in transition.

@nonprofittechy
nonprofittechy merged commit 3d0c340 into main Nov 5, 2026
2 checks passed
@nonprofittechy
nonprofittechy deleted the restore-yaml-anatomy branch November 5, 2026 18:01
@BryceStevenWilley

Copy link
Copy Markdown
Contributor

Restores docs/authoring/weaver_code_anatomy.md

Couldn't this info myself, but why was it removed in the first place?

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