Skip to content

docs(activation): fix profile.d ordering vs [vars] - #55

Open
djsauble wants to merge 1 commit into
docs/plugins-concept-pagefrom
later-triage/fix-profile-d-ordering
Open

docs(activation): fix profile.d ordering vs [vars]#55
djsauble wants to merge 1 commit into
docs/plugins-concept-pagefrom
later-triage/fix-profile-d-ordering

Conversation

@djsauble

Copy link
Copy Markdown
Contributor

Summary

  • docs(activation): show where plugins hook into the activation timeline #53 (merged into this branch) added a profile.d step to the activation timeline, but placed it after [vars] is set — the actual order is the reverse.
  • Confirmed against Tanja's profile.d/plugins architecture doc (shared in the #submit-spec-review thread): profile.d scripts run early, before [vars], before [hook].on-activate. [vars] is not yet visible to profile.d scripts.
  • James Bayer caught the discrepancy live while reading docs(activation): show where plugins hook into the activation timeline #53's diagram against the CLI's flox-activate.md comments, then confirmed the correct order via Tanja's doc himself.
  • Swaps the two diagram steps and reorders/adjusts the prose sentence accordingly. No other content changes.

Found via later-triage while sweeping the control-DM thread for new saves.

Test plan

  • Docs site renders the mermaid diagram correctly
  • Ordering matches Tanja's profile.d/plugins doc and the activation interpreter source

profile.d scripts run before [vars] is set, not after — confirmed
against Tanja's profile.d/plugins architecture doc. James caught the
discrepancy in #53 while reviewing the merged activation-timeline change.
Comment thread concepts/activation.mdx
Comment on lines +284 to +285
[[vars] section of your manifest](/man/manifest.toml#vars) — these aren't yet
visible to profile.d scripts, only to what runs after them.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

"yet" is a weird word to use, since [[vars]] will never be visible to profile scripts due to the order in which they're run.

Suggested change
[[vars] section of your manifest](/man/manifest.toml#vars) — these aren't yet
visible to profile.d scripts, only to what runs after them.
[[vars] section of your manifest](/man/manifest.toml#vars) — these aren't
visible to profile.d scripts, only to what runs after them.

@djsauble
djsauble marked this pull request as ready for review July 30, 2026 21:54
@djsauble djsauble self-assigned this Jul 30, 2026
@djsauble
djsauble requested a review from tanjadev July 30, 2026 21:54
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