Skip to content

User guide: fix typos, broken links and stale labels - #5709

Merged
awwaiid merged 2 commits into
mainfrom
guide/02-guide-typos-and-links
Sep 19, 2026
Merged

awwaiid merged 2 commits into
mainfrom
guide/02-guide-typos-and-links

Conversation

@awwaiid

@awwaiid awwaiid commented Sep 5, 2026

Copy link
Copy Markdown
Collaborator

Mechanical fixes only, no new content:

  • Index: repair broken links (editing/reactivating partners, distributions by county, donation sites, inventory adjustments, both mailer pages), fix numbering, add the reminder emails page.
  • Rename two mailer preview files with odd names (a comma instead of a dot; a capital P).
  • Fix bare or wrong links and anchors on the Donations, Purchases, Storage Locations, Kits, Partner Groups, Partner Statuses, Request Cycle and Barcodes pages, and two image references that pointed at files that don't exist.
  • Spelling and punctuation (dashbboard, Pequests, alloocation, organizaation, cliock, Gorm, Drivess, Organisation, duplicated half-sentences) and admonition tags (WARN/INFO/Note).
  • Button and status names updated to match the app (New Partner Agency, New Announcement, Edit Partner Profile, Awaiting review, Log Out, Donations - Manufacturer, Partner approved!).

Stacked on #5708 (merge that first, or this PR's diff will include it).

🤖 Generated with Claude Code

https://claude.ai/code/session_01LMAt57FU2qBq45yR7YCsEZ

awwaiid and others added 2 commits September 5, 2026 17:59
Ruby 3.4 stopped bundling these as default gems, so 'bundle exec jekyll
serve' in docs/ failed with 'cannot load such file -- csv'.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LMAt57FU2qBq45yR7YCsEZ
- Index: repair six broken links (editing/reactivating partners,
  distributions by county, donation sites, inventory adjustments, the
  two mailer pages), fix numbering, add the reminder emails page.
- Rename the two mailer preview files with odd names (a comma instead
  of a dot, and a capital P).
- Fix bare or wrong links on the Donations, Purchases, Storage
  Locations, Kits, Partner Groups, Partner Statuses, Request Cycle and
  Barcodes pages, and point anchors at the right sections.
- Fix spelling and punctuation (dashbboard, Pequests, alloocation,
  organizaation, cliock, Gorm, Drivess, Organisation, a dropped 'T',
  duplicated half-sentences) and admonition tags (WARN/INFO/Note).
- Match button and status names to the app (New Partner Agency, New
  Announcement, Edit Partner Profile, Awaiting review, Log Out,
  Donations - Manufacturer, Partner approved!).

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LMAt57FU2qBq45yR7YCsEZ

In the Partner's view of the system, they can click on "Edit My Profile" to fill in all the information you want.
Once they have saved this, they will also see a "Submit for Approval" button. Clicking that changes their status to "Waiting for Approval", and makes them appear in your [dashboard](essentials_dashboard.md) list of partners waiting for approval, as well as making a "Review Partner's application" button appear beside them in your view of all the Partners.
Once they have saved this, they will also see a "Submit for Approval" button. Clicking that changes their status to "Awaiting review", and makes them appear in your [dashboard](essentials_dashboard.md) list of partners waiting for approval, as well as making a "Review Applicant's Profile" button appear beside them in your view of all the Partners.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

We changed the display for this I think

@awwaiid

awwaiid commented Sep 6, 2026

Copy link
Copy Markdown
Collaborator Author

All looks good to me.

@cielf cielf left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Just one tiny thing. Thanks for doing this pass!


#### Reactivating an Item
To reactivate an Item, you'll need to
(1) click "Also include inactive Items"

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

I believe we have a standard that "Item" is always capitalized. Maybe that needs to be addressed on the appropriate screen.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

Looks like it is indeed in the app lower-case here, alongside a similar checkbox on other screens like "Also include inactive vendors" and "Also include inactive donation sites".

We can separately update the app... I'm fine either way for leave this lower-case now because it is correct or capitalize it now because it is how it should/will be. Which would you prefer?

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

It's close enough that there won't be any confusion -- let's make it how it should be.

Base automatically changed from guide/01-docs-jekyll-ruby34 to main September 18, 2026 19:29
@awwaiid
awwaiid added this pull request to stack #5724 September 19, 2026 18:13
@awwaiid
awwaiid merged commit 6aa0d2c into main Sep 19, 2026
22 checks passed
@awwaiid
awwaiid deleted the guide/02-guide-typos-and-links branch September 19, 2026 18:14
@github-actions

Copy link
Copy Markdown
Contributor

@awwaiid: Your PR User guide: fix typos, broken links and stale labels is part of today's Human Essentials production release: 2026.09.20.
Thank you very much for your contribution!

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