Skip to content

Commit 9177760

Browse files
kzndotshkzndotsh
committed
docs(docs): dropdown navigation, flat routes, Lucide icons
- Switch root navigation from tabs to sidebar dropdowns; add per-dropdown icons - Set icons.library to lucide; use cloud icon for atl.dev - Move product MDX from products/ to top-level portal, chat, sh, dev, tools, wiki, tux - Adjust slate-forward colors in docs.json; update turbo build inputs and IA copy (Assistant, AGENTS, about, index, navigation) Made-with: Cursor
1 parent aca56b8 commit 9177760

File tree

14 files changed

+85
-64
lines changed

14 files changed

+85
-64
lines changed

‎apps/docs/.mintlify/Assistant.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
You help readers use **All Things Linux** technical documentation. **All Things Linux (ATL)** is a volunteer-driven **501(c)(3)** non-profit Linux community ([allthingslinux.org](https://allthingslinux.org))—open education, community-built tools, and a large volunteer ecosystem.
44

5-
Content is grouped by **product** (for example **portal** immediately after **Overview**, then atl.chat, atl.sh, atl.dev, atl.tools, atl.wiki, tux). Route users to the right tab when a question is product-specific. The **Authoring** tab and **Overview** explain this Mintlify site and the monorepo docs workflow—not the full organizational policy handbook.
5+
Content is grouped by **product** in **sidebar dropdowns** (for example **portal** after **Overview**, then atl.chat, atl.sh, atl.dev, atl.tools, atl.wiki, tux). Route users to the right dropdown when a question is product-specific. The **Authoring** dropdown and **Overview** explain this Mintlify site and the monorepo docs workflow—not the full organizational policy handbook.
66

77
## Tone
88

‎apps/docs/AGENTS.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@
1313
## Terminology
1414

1515
- **All Things Linux** / **ATL** — The organization ([allthingslinux.org](https://allthingslinux.org), [GitHub](https://github.com/allthingslinux)).
16-
- **Docs** — This Mintlify site: **Overview** first, then **product tabs** (portal, atl.chat, atl.sh, atl.dev, atl.tools, atl.wiki, tux), then **Authoring** and **API reference**; not the full internal org handbook unless we add explicit pages.
16+
- **Docs** — This Mintlify site: **Overview** first, then **product dropdowns** in the sidebar (portal, atl.chat, atl.sh, atl.dev, atl.tools, atl.wiki, tux), then **Authoring** and **API reference**; not the full internal org handbook unless we add explicit pages.
1717
- **Monorepo** — The repository containing `apps/docs`, `apps/web`, `apps/portal`, and shared packages.
1818
- **non-profit** — Hyphenated in ATL communications (501(c)(3) status).
1919
- Prefer **FOSS** / **open source**, **community-driven**, **beginner** (not “noob”), **accessible** (honest about difficulty—see org terminology guide).

‎apps/docs/about.mdx‎

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ description: "Who we are: a volunteer-driven non-profit Linux community, and how
99

1010
**Mantra:** _Connection. Education. Empowerment._
1111

12-
This site is split into **product tabs** (**portal** right after **Overview**, then atl.chat, atl.sh, and others) plus **Authoring** for Mintlify workflows. It is not a full organizational handbook. For governance, brand, and policies, use the resources below.
12+
This site uses **sidebar dropdowns** for each major surface (**Overview**, **portal**, atl.chat, atl.sh, and others) plus **Authoring** for Mintlify workflows. It is not a full organizational handbook. For governance, brand, and policies, use the resources below.
1313

1414
## Where to learn more
1515

@@ -22,17 +22,17 @@ This site is split into **product tabs** (**portal** right after **Overview**, t
2222

2323
## Ecosystem names you may see
2424

25-
| Term | In these docs |
26-
| ------------- | ---------------------------------------------------------------------- |
27-
| **ATL** | All Things Linux — the organization |
28-
| **portal** | [portal](/products/portal/index) — identity hub (`apps/portal` in git) |
29-
| **atl.chat** | [atl.chat](/products/atl-chat/index) — multi-protocol chat |
30-
| **atl.sh** | [atl.sh](/products/atl-sh/index) — pubnix / public Unix |
31-
| **atl.dev** | [atl.dev](/products/atl-dev/index) — developer platform |
32-
| **atl.tools** | [atl.tools](/products/atl-tools/index) — self-hosted services, mirrors |
33-
| **atl.wiki** | [atl.wiki](/products/atl-wiki/index) — MediaWiki knowledge base |
34-
| **tux** | [tux](/products/tux/index) — Discord bot |
35-
| **FOSS** | Free and open-source software |
25+
| Term | In these docs |
26+
| ------------- | ------------------------------------------------------- |
27+
| **ATL** | All Things Linux — the organization |
28+
| **portal** | [portal](/portal) — identity hub (`apps/portal` in git) |
29+
| **atl.chat** | [atl.chat](/chat) — multi-protocol chat |
30+
| **atl.sh** | [atl.sh](/sh) — pubnix / public Unix |
31+
| **atl.dev** | [atl.dev](/dev) — developer platform |
32+
| **atl.tools** | [atl.tools](/tools) — self-hosted services, mirrors |
33+
| **atl.wiki** | [atl.wiki](/wiki) — MediaWiki knowledge base |
34+
| **tux** | [tux](/tux) — Discord bot |
35+
| **FOSS** | Free and open-source software |
3636

3737
## This documentation site
3838

apps/docs/products/atl-chat/index.mdx renamed to apps/docs/chat/index.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -20,5 +20,5 @@ When the bridge resolves users against **portal**, use the **same secret** on bo
2020

2121
## Related
2222

23-
- [portal](/products/portal/index) — accounts and bridge identity
24-
- [atl.sh](/products/atl-sh/index) — community `#support` on `irc.atl.chat` (see atl.sh README)
23+
- [portal](/portal) — accounts and bridge identity
24+
- [atl.sh](/sh) — community `#support` on `irc.atl.chat` (see atl.sh README)

apps/docs/products/atl-dev/index.mdx renamed to apps/docs/dev/index.mdx

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,6 @@ The **[iso.atl.dev](https://github.com/allthingslinux/iso.atl.dev)** repository
1818

1919
## Related
2020

21-
- [portal](/products/portal/index) — identity across ATL domains
22-
- [atl.sh](/products/atl-sh/index) — pubnix and shell access
23-
- [tux](/products/tux/index) — Discord bot; documentation on tux.atl.dev
21+
- [portal](/portal) — identity across ATL domains
22+
- [atl.sh](/sh) — pubnix and shell access
23+
- [tux](/tux) — Discord bot; documentation on tux.atl.dev

‎apps/docs/docs.json‎

Lines changed: 36 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -2,13 +2,16 @@
22
"$schema": "https://mintlify.com/docs.json",
33
"theme": "mint",
44
"name": "All Things Linux",
5-
"description": "Product and platform documentation for All Things Linux: portal, atl.chat, atl.sh, atl.dev, atl.tools, atl.wiki, tux, plus Mintlify authoring guides. 501(c)(3) Linux community.",
5+
"description": "All Things Linux is a 501(c)(3) non-profit organization with a mission to empower the Linux ecosystem through education, collaboration, and support.",
66
"colors": {
7-
"primary": "#16A34A",
8-
"light": "#07C983",
9-
"dark": "#15803D"
7+
"primary": "#64748b",
8+
"light": "#94a3b8",
9+
"dark": "#475569"
1010
},
1111
"favicon": "/favicon.svg",
12+
"icons": {
13+
"library": "lucide"
14+
},
1215
"seo": {
1316
"indexing": "navigable",
1417
"metatags": {
@@ -18,7 +21,7 @@
1821
}
1922
},
2023
"search": {
21-
"prompt": "Search All Things Linux docs…"
24+
"prompt": "Enter a search term…"
2225
},
2326
"api": {
2427
"openapi": "api-reference/openapi.json",
@@ -30,9 +33,10 @@
3033
}
3134
},
3235
"navigation": {
33-
"tabs": [
36+
"dropdowns": [
3437
{
35-
"tab": "Overview",
38+
"dropdown": "Overview",
39+
"icon": "layout-grid",
3640
"groups": [
3741
{
3842
"group": "Getting started",
@@ -47,70 +51,78 @@
4751
]
4852
},
4953
{
50-
"tab": "portal",
54+
"dropdown": "portal",
55+
"icon": "user",
5156
"groups": [
5257
{
5358
"group": "Documentation",
54-
"pages": ["products/portal/index"]
59+
"pages": ["portal/index"]
5560
}
5661
]
5762
},
5863
{
59-
"tab": "atl.chat",
64+
"dropdown": "atl.chat",
65+
"icon": "messages-square",
6066
"groups": [
6167
{
6268
"group": "Documentation",
63-
"pages": ["products/atl-chat/index"]
69+
"pages": ["chat/index"]
6470
}
6571
]
6672
},
6773
{
68-
"tab": "atl.sh",
74+
"dropdown": "atl.sh",
75+
"icon": "terminal",
6976
"groups": [
7077
{
7178
"group": "Documentation",
72-
"pages": ["products/atl-sh/index"]
79+
"pages": ["sh/index"]
7380
}
7481
]
7582
},
7683
{
77-
"tab": "atl.dev",
84+
"dropdown": "atl.dev",
85+
"icon": "cloud",
7886
"groups": [
7987
{
8088
"group": "Documentation",
81-
"pages": ["products/atl-dev/index"]
89+
"pages": ["dev/index"]
8290
}
8391
]
8492
},
8593
{
86-
"tab": "atl.tools",
94+
"dropdown": "atl.tools",
95+
"icon": "server",
8796
"groups": [
8897
{
8998
"group": "Documentation",
90-
"pages": ["products/atl-tools/index"]
99+
"pages": ["tools/index"]
91100
}
92101
]
93102
},
94103
{
95-
"tab": "atl.wiki",
104+
"dropdown": "atl.wiki",
105+
"icon": "book-marked",
96106
"groups": [
97107
{
98108
"group": "Documentation",
99-
"pages": ["products/atl-wiki/index"]
109+
"pages": ["wiki/index"]
100110
}
101111
]
102112
},
103113
{
104-
"tab": "tux",
114+
"dropdown": "tux",
115+
"icon": "bot",
105116
"groups": [
106117
{
107118
"group": "Documentation",
108-
"pages": ["products/tux/index"]
119+
"pages": ["tux/index"]
109120
}
110121
]
111122
},
112123
{
113-
"tab": "Authoring",
124+
"dropdown": "Authoring",
125+
"icon": "pen-line",
114126
"groups": [
115127
{
116128
"group": "Site configuration",
@@ -136,7 +148,8 @@
136148
]
137149
},
138150
{
139-
"tab": "API reference",
151+
"dropdown": "API reference",
152+
"icon": "braces",
140153
"groups": [
141154
{
142155
"group": "API documentation",

‎apps/docs/essentials/navigation.mdx‎

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,15 @@
11
---
22
title: "Navigation"
3-
description: "Define tabs, groups, and page order in docs.json so readers can browse guides and API reference"
3+
description: "Define tabs or dropdowns, groups, and page order in docs.json so readers can browse guides and API reference"
44
icon: "map"
55
---
66

77
The navigation menu is the list of links on every website.
88

99
You will likely update `docs.json` every time you add a new page. Pages do not show up automatically.
1010

11+
The live ATL docs use root-level **`dropdowns`** in `docs.json` (expandable sections at the top of the sidebar). The JSON examples below often use **`tabs`**; the same `groups` / `pages` shapes apply to each `dropdown` entry.
12+
1113
## Navigation syntax
1214

1315
Our navigation syntax is recursive which means you can make nested navigation groups. You don't need to include `.mdx` in page names.

‎apps/docs/index.mdx‎

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -19,28 +19,28 @@ Welcome. **[All Things Linux](https://allthingslinux.org) (ATL)** is a volunteer
1919

2020
## Products
2121

22-
Documentation for each major ATL surface lives on its own tab:
22+
Documentation for each major ATL surface lives under its own **dropdown** in the sidebar:
2323

2424
<Columns cols={2}>
25-
<Card title="portal" icon="user" href="/products/portal/index">
25+
<Card title="portal" icon="user" href="/portal">
2626
Identity, authentication, and the portal app.
2727
</Card>
28-
<Card title="atl.chat" icon="comments" href="/products/atl-chat/index">
28+
<Card title="atl.chat" icon="comments" href="/chat">
2929
IRC, XMPP, and multi-protocol chat.
3030
</Card>
31-
<Card title="atl.sh" icon="terminal" href="/products/atl-sh/index">
31+
<Card title="atl.sh" icon="terminal" href="/sh">
3232
Public Unix (pubnix) and shell access.
3333
</Card>
34-
<Card title="atl.dev" icon="code" href="/products/atl-dev/index">
34+
<Card title="atl.dev" icon="code" href="/dev">
3535
Developer platform and FOSS hosting.
3636
</Card>
37-
<Card title="atl.tools" icon="server" href="/products/atl-tools/index">
37+
<Card title="atl.tools" icon="server" href="/tools">
3838
Self-hosted services and mirrors.
3939
</Card>
40-
<Card title="atl.wiki" icon="book" href="/products/atl-wiki/index">
40+
<Card title="atl.wiki" icon="book" href="/wiki">
4141
MediaWiki knowledge base.
4242
</Card>
43-
<Card title="tux" icon="robot" href="/products/tux/index">
43+
<Card title="tux" icon="robot" href="/tux">
4444
Discord bot—moderation, leveling, utilities.
4545
</Card>
4646
</Columns>
@@ -55,10 +55,10 @@ Documentation for each major ATL surface lives on its own tab:
5555
Branches, CI, and file layout for these docs.
5656
</Card>
5757
<Card title="Site configuration" icon="palette" href="/essentials/settings">
58-
`docs.json` and branding (Authoring tab).
58+
`docs.json` and branding (Authoring dropdown).
5959
</Card>
6060
<Card title="Navigation" icon="map" href="/essentials/navigation">
61-
Tabs, groups, and page paths.
61+
Dropdowns, groups, and page paths.
6262
</Card>
6363
<Card
6464
title="API reference"
@@ -71,7 +71,7 @@ Documentation for each major ATL surface lives on its own tab:
7171

7272
## Editing the documentation site
7373

74-
The **Authoring** tab has MDX, code blocks, images, snippets, and AI-tool guides for contributors working on Mintlify content.
74+
The **Authoring** dropdown has MDX, code blocks, images, snippets, and AI-tool guides for contributors working on Mintlify content.
7575

7676
<Columns cols={2}>
7777
<Card title="MDX" icon="pen-fancy" href="/essentials/markdown">

apps/docs/products/portal/index.mdx renamed to apps/docs/portal/index.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -20,5 +20,5 @@ Set **`BRIDGE_SERVICE_TOKEN`** (portal) to the same value as atl.chat’s **`BRI
2020

2121
## Related
2222

23-
- [atl.chat](/products/atl-chat/index) — IRC/XMPP/bridge stack
24-
- [tux](/products/tux/index) — Discord bot and server tooling
23+
- [atl.chat](/chat) — IRC/XMPP/bridge stack
24+
- [tux](/tux) — Discord bot and server tooling

apps/docs/products/atl-sh/index.mdx renamed to apps/docs/sh/index.mdx

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,6 @@ The deployment repo uses **Ansible** (roles for packages, security, users, servi
1818

1919
## Related
2020

21-
- [portal](/products/portal/index) — account provisioning
22-
- [atl.chat](/products/atl-chat/index) — IRC network for support
23-
- [atl.dev](/products/atl-dev/index) — developer-facing services
21+
- [portal](/portal) — account provisioning
22+
- [atl.chat](/chat) — IRC network for support
23+
- [atl.dev](/dev) — developer-facing services

0 commit comments

Comments
 (0)