Skip to content

IA refresh - #6902

Merged
ethanpalm merged 5 commits into
mainfrom
IA-refresh
Aug 7, 2026
Merged

IA refresh#6902
ethanpalm merged 5 commits into
mainfrom
IA-refresh

Conversation

@ethanpalm

@ethanpalm ethanpalm commented Aug 6, 2026

Copy link
Copy Markdown
Collaborator

Documentation changes

This PR reworks our information architecture to advance multiple goals.

  • Reduce sprawl: sidebar is getting full and messy
  • Make it easier to accept automations: adds the help-center dir so that hidden stub pages can start to populate context for the assistant without bloating the main content
    • Concepts and Glossary pages also give automations landing spots for conceptual info without growing other pages
  • JTBD IA: group concepts people need
  • Foundation for adding help center page: can use the assistant page for a help center tab to give people a chat-first docs experience

For Reviewers

When reviewing documentation PRs, please consider:

✅ Technical accuracy

  • Code examples work as written
  • Commands and configurations are correct
  • Links resolve to the right destinations
  • Prerequisites and requirements are accurate

✅ Clarity and completeness

  • Instructions are clear and easy to follow
  • Steps are in logical order
  • Nothing important is missing
  • Examples help illustrate the concepts

✅ User experience

  • A new user could follow these docs successfully
  • Common gotchas or edge cases are addressed
  • Error messages or troubleshooting guidance is helpful

@mintlify

mintlify Bot commented Aug 6, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
tomee 🟢 Ready View Preview Aug 6, 2026, 11:53 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

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