docs: split API Docs features, More menu, Mock Servers placeholder

[anthonyd-bruno]

Note

Stacked on #163 — this PR targets docs/restructure-by-product, not main, so it shows only the new work. If #163 merges first, GitHub will retarget it to main automatically.

What this does

1. Separates writing docs from generated HTML docs (API Docs tab)

Feedback was that the in-app markdown docs and the auto-generated HTML docs read as one confusing feature. The tab now has two clearly-named groups:

• Write Docs in Bruno — the four authoring pages (workspace/collection/folder/request), paths unchanged
• Generate HTML Docs — new html-docs/ section split from api-docs/auto-generate-docs at its existing headings: Overview, Generate Docs, Environments, Search, Interactive Playground, Deploy & Share

The tab overview is rewritten as a two-feature router (card comparison + how the features connect). /api-docs/auto-generate-docs gets a permanent redirect to /html-docs/overview, which also covers the absolute link from the v3 overview.

2. Collapses Reference + Licensing into a "More" navbar menu

Clicking More opens a dropdown with the two sections (with descriptions) plus a curated list of popular pages: JavaScript API Reference, Postman Migration, Environment Variables, OAuth 2.0. Popular links use single-page pages entries — the schema's item+href variant is broken in the renderer (drops the href, lands on the default page).

3. Adds a Mock Servers tab as a structural placeholder

One coming-soon overview page under mock-servers/, slotted between API Docs and VS Code Extension. Note: this is publicly visible once deployed — hold this if the release shouldn't be signaled yet (or we can add noindex).

4. Fixes silently-blank icons

Mintlify resolves icon names against Font Awesome, not Lucide, and mint validate doesn't catch invalid names — they just render as empty space. Fixed braces→brackets-curly, arrow-right-left→right-left, layers→layer-group, and the API Client tab's app-window→browser (blank since #163).

Verification

• mint validate passes; mint broken-links reports the same pre-existing set as the base branch, none new
• All redirects preserved; only new URL scheme is html-docs/* (redirected from the old page)
• Menu navigation and icon rendering verified by clicking through the rendered site in a headless browser (every menu item lands on its page; every tab/menu icon renders a visible SVG; every icon name returns 200 from Mintlify's Font Awesome CDN)

🤖 Generated with Claude Code

[anthonyd-bruno]

Superseded by #170 — same changes, but with the head branch pushed to usebruno so the Mintlify preview deployment can build (the bot doesn't run on fork branches).