New Ecosystem tab

[FredKSchott]

Restructures the docs sidebar from 5 tabs to 4 tabs:

• Tutorial (new): Moves the tutorial into its own, new tab section.
• Guide: Brings together all guides about Astro into a single section. Absorbs the old "start" tab group, minus the tutorial.
• Reference: Unchanged.
• Ecosystem (new): Brings together all content about the Astro ecosystem into a single section. Combines integrations, third-party services, etc.

My initial goal was to clean up our third-party + first-party integration content. As part of that, I'll create a single organizational structure that covers both, which means restructuring the docs sidebar from 5 -> 4 in a way that doesn't feel bolted on. The next PR will tackle the actual third-party guides themselves.

The only content change was combining "publishing to npm" with "integrations overview" into a new "Guides > Working with Integrations" guide. This felt natural, but also allowed us to cleanly merge the old "Integrations" tab group sections into the new "Ecosystem" by getting rid of the two "special" pages and moving them into a focused guide.

Translations were updated with the help of Opus 4.6. Because I was just moving content around and not creating anything net new, this felt like the right approach with minimal risk to translation errors, but @yanthomasdev LMK if any concerns.

[netlify]

✅ Deploy Preview for astro-docs-2 ready!

Name	Link
🔨 Latest commit	fbbf15b
🔍 Latest deploy log	https://app.netlify.com/projects/astro-docs-2/deploys/69c448ba593a5f000826db3b
😎 Deploy Preview	https://deploy-preview-13571--astro-docs-2.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[astrobot-houston]

Lunaria Status Overview

🌕 This pull request will trigger status changes.

Learn more

By default, every PR changing files present in the Lunaria configuration's files property will be considered and trigger status changes accordingly.

You can change this by adding one of the keywords present in the ignoreKeywords property in your Lunaria configuration file in the PR's title (ignoring all files) or by including a tracker directive in the merged commit's description.

Tracked Files

File	Note
ar/concepts/why-astro.mdx	Localization changed, will be marked as complete.
ar/getting-started.mdx	Localization changed, will be marked as complete.
de/concepts/why-astro.mdx	Localization changed, will be marked as complete.
de/getting-started.mdx	Localization changed, will be marked as complete.
de/guides/cms/index.mdx	Localization changed, will be marked as complete.
de/guides/dev-toolbar.mdx	Localization changed, will be marked as complete.
de/tutorial/6-islands/1.mdx	Localization changed, will be marked as complete.
en/concepts/why-astro.mdx	Source changed, localizations will be marked as outdated.
en/getting-started.mdx	Source changed, localizations will be marked as outdated.
en/guides/cms/index.mdx	Source changed, localizations will be marked as outdated.
en/guides/content-collections.mdx	Source changed, localizations will be marked as outdated.
en/guides/dev-toolbar.mdx	Source changed, localizations will be marked as outdated.
en/guides/framework-components.mdx	Source changed, localizations will be marked as outdated.
en/guides/integrations-guide/alpinejs.mdx	Source changed, localizations will be marked as outdated.
en/guides/integrations-guide/cloudflare.mdx	Source changed, localizations will be marked as outdated.
en/guides/integrations-guide/index.mdx	Source removed, will stop being tracked.
en/guides/integrations-guide/markdoc.mdx	Source changed, localizations will be marked as outdated.
en/guides/integrations-guide/mdx.mdx	Source changed, localizations will be marked as outdated.
en/guides/integrations-guide/netlify.mdx	Source changed, localizations will be marked as outdated.
en/guides/integrations-guide/partytown.mdx	Source changed, localizations will be marked as outdated.
en/guides/integrations-guide/preact.mdx	Source changed, localizations will be marked as outdated.
en/guides/integrations-guide/react.mdx	Source changed, localizations will be marked as outdated.
en/guides/integrations-guide/sitemap.mdx	Source changed, localizations will be marked as outdated.
en/guides/integrations-guide/solid-js.mdx	Source changed, localizations will be marked as outdated.
en/guides/integrations-guide/svelte.mdx	Source changed, localizations will be marked as outdated.
en/guides/integrations-guide/vercel.mdx	Source changed, localizations will be marked as outdated.
en/guides/integrations-guide/vue.mdx	Source changed, localizations will be marked as outdated.
en/guides/integrations.mdx	Localization added, will be marked as complete.
en/guides/middleware.mdx	Source changed, localizations will be marked as outdated.
en/guides/migrate-to-astro/from-gatsby.mdx	Source changed, localizations will be marked as outdated.
en/guides/migrate-to-astro/from-nextjs.mdx	Source changed, localizations will be marked as outdated.
en/guides/migrate-to-astro/from-nuxtjs.mdx	Source changed, localizations will be marked as outdated.
en/guides/migrate-to-astro/from-pelican.mdx	Source changed, localizations will be marked as outdated.
en/guides/on-demand-rendering.mdx	Source changed, localizations will be marked as outdated.
en/guides/troubleshooting.mdx	Source changed, localizations will be marked as outdated.
en/guides/upgrade-to/v1.mdx	Localization changed, will be marked as complete.
en/guides/upgrade-to/v3.mdx	Source changed, localizations will be marked as outdated.
en/guides/upgrade-to/v4.mdx	Source changed, localizations will be marked as outdated.
en/guides/upgrade-to/v5.mdx	Source changed, localizations will be marked as outdated.
en/guides/upgrade-to/v6.mdx	Source changed, localizations will be marked as outdated.
en/install-and-setup.mdx	Source changed, localizations will be marked as outdated.
en/recipes/making-toolbar-apps.mdx	Source changed, localizations will be marked as outdated.
en/reference/cli-reference.mdx	Source changed, localizations will be marked as outdated.
en/reference/configuration-reference.mdx	Source changed, localizations will be marked as outdated.
en/reference/content-loader-reference.mdx	Source changed, localizations will be marked as outdated.
en/reference/errors/client-address-not-available.mdx	Source changed, localizations will be marked as outdated.
en/reference/errors/no-matching-renderer.mdx	Source changed, localizations will be marked as outdated.
en/reference/integrations-reference.mdx	Source changed, localizations will be marked as outdated.
en/reference/modules/astro-app.mdx	Source changed, localizations will be marked as outdated.
en/tutorial/0-introduction/index.mdx	Source changed, localizations will be marked as outdated.
en/tutorial/1-setup/index.mdx	Source changed, localizations will be marked as outdated.
en/tutorial/2-pages/index.mdx	Source changed, localizations will be marked as outdated.
en/tutorial/3-components/index.mdx	Source changed, localizations will be marked as outdated.
en/tutorial/4-layouts/index.mdx	Source changed, localizations will be marked as outdated.
en/tutorial/5-astro-api/index.mdx	Source changed, localizations will be marked as outdated.
en/tutorial/6-islands/1.mdx	Source changed, localizations will be marked as outdated.
en/tutorial/6-islands/index.mdx	Source changed, localizations will be marked as outdated.
es/concepts/why-astro.mdx	Localization changed, will be marked as complete.
es/getting-started.mdx	Localization changed, will be marked as complete.
es/guides/on-demand-rendering.mdx	Localization changed, will be marked as complete.
es/install-and-setup.mdx	Localization changed, will be marked as complete.
es/recipes/making-toolbar-apps.mdx	Localization changed, will be marked as complete.
es/reference/errors/client-address-not-available.mdx	Localization changed, will be marked as complete.
es/reference/errors/no-matching-renderer.mdx	Localization changed, will be marked as complete.
es/reference/publish-to-npm.mdx	Localization removed, will be marked as missing.
es/tutorial/6-islands/1.mdx	Localization changed, will be marked as complete.
fr/concepts/why-astro.mdx	Localization changed, will be marked as complete.
fr/getting-started.mdx	Localization changed, will be marked as complete.
fr/guides/cms/index.mdx	Localization changed, will be marked as complete.
fr/guides/content-collections.mdx	Localization changed, will be marked as complete.
fr/guides/dev-toolbar.mdx	Localization changed, will be marked as complete.
fr/guides/framework-components.mdx	Localization changed, will be marked as complete.
fr/guides/integrations-guide/alpinejs.mdx	Localization changed, will be marked as complete.
fr/guides/integrations-guide/cloudflare.mdx	Localization changed, will be marked as complete. 🔄️
fr/guides/integrations-guide/index.mdx	Localization removed, will be marked as missing.
fr/guides/integrations-guide/markdoc.mdx	Localization changed, will be marked as complete.
fr/guides/integrations-guide/mdx.mdx	Localization changed, will be marked as complete.
fr/guides/integrations-guide/netlify.mdx	Localization changed, will be marked as complete.
fr/guides/integrations-guide/partytown.mdx	Localization changed, will be marked as complete.
fr/guides/integrations-guide/preact.mdx	Localization changed, will be marked as complete.
fr/guides/integrations-guide/react.mdx	Localization changed, will be marked as complete.
fr/guides/integrations-guide/sitemap.mdx	Localization changed, will be marked as complete.
fr/guides/integrations-guide/solid-js.mdx	Localization changed, will be marked as complete.
fr/guides/integrations-guide/svelte.mdx	Localization changed, will be marked as complete.
fr/guides/integrations-guide/vercel.mdx	Localization changed, will be marked as complete.
fr/guides/integrations-guide/vue.mdx	Localization changed, will be marked as complete.
fr/guides/middleware.mdx	Localization changed, will be marked as complete.
fr/guides/migrate-to-astro/from-gatsby.mdx	Localization changed, will be marked as complete.
fr/guides/migrate-to-astro/from-nextjs.mdx	Localization changed, will be marked as complete.
fr/guides/migrate-to-astro/from-nuxtjs.mdx	Localization changed, will be marked as complete.
fr/guides/migrate-to-astro/from-pelican.mdx	Localization changed, will be marked as complete.
fr/guides/on-demand-rendering.mdx	Localization changed, will be marked as complete.
fr/guides/troubleshooting.mdx	Localization changed, will be marked as complete.
fr/guides/upgrade-to/v1.mdx	Localization changed, will be marked as complete.
fr/guides/upgrade-to/v3.mdx	Localization changed, will be marked as complete.
fr/guides/upgrade-to/v4.mdx	Localization changed, will be marked as complete.
fr/guides/upgrade-to/v5.mdx	Localization changed, will be marked as complete.
fr/install-and-setup.mdx	Localization changed, will be marked as complete.
fr/recipes/making-toolbar-apps.mdx	Localization changed, will be marked as complete.
fr/reference/cli-reference.mdx	Localization changed, will be marked as complete.
fr/reference/configuration-reference.mdx	Localization changed, will be marked as complete.
fr/reference/content-loader-reference.mdx	Localization changed, will be marked as complete.
fr/reference/errors/client-address-not-available.mdx	Localization changed, will be marked as complete.
fr/reference/errors/no-matching-renderer.mdx	Localization changed, will be marked as complete.
fr/reference/integrations-reference.mdx	Localization changed, will be marked as complete.
fr/reference/modules/astro-app.mdx	Localization changed, will be marked as complete.
fr/reference/publish-to-npm.mdx	Localization removed, will be marked as missing.
fr/tutorial/6-islands/1.mdx	Localization changed, will be marked as complete.
hi/concepts/why-astro.mdx	Localization changed, will be marked as complete.
hi/getting-started.mdx	Localization changed, will be marked as complete.
it/concepts/why-astro.mdx	Localization changed, will be marked as complete.
it/getting-started.mdx	Localization changed, will be marked as complete.
it/tutorial/6-islands/1.mdx	Localization changed, will be marked as complete.
ja/concepts/why-astro.mdx	Localization changed, will be marked as complete.
ja/getting-started.mdx	Localization changed, will be marked as complete.
ja/guides/dev-toolbar.mdx	Localization changed, will be marked as complete.
ja/guides/framework-components.mdx	Localization changed, will be marked as complete.
ja/guides/integrations-guide/alpinejs.mdx	Localization changed, will be marked as complete.
ja/guides/integrations-guide/index.mdx	Localization removed, will be marked as missing.
ja/guides/integrations-guide/markdoc.mdx	Localization changed, will be marked as complete.
ja/guides/integrations-guide/mdx.mdx	Localization changed, will be marked as complete.
ja/guides/integrations-guide/netlify.mdx	Localization changed, will be marked as complete.
ja/guides/integrations-guide/partytown.mdx	Localization changed, will be marked as complete.
ja/guides/integrations-guide/preact.mdx	Localization changed, will be marked as complete.
ja/guides/integrations-guide/react.mdx	Localization changed, will be marked as complete.
ja/guides/integrations-guide/solid-js.mdx	Localization changed, will be marked as complete.
ja/guides/integrations-guide/svelte.mdx	Localization changed, will be marked as complete.
ja/guides/integrations-guide/vercel.mdx	Localization changed, will be marked as complete.
ja/guides/integrations-guide/vue.mdx	Localization changed, will be marked as complete.
ja/guides/migrate-to-astro/from-gatsby.mdx	Localization changed, will be marked as complete.
ja/guides/migrate-to-astro/from-pelican.mdx	Localization changed, will be marked as complete.
ja/guides/on-demand-rendering.mdx	Localization changed, will be marked as complete.
ja/guides/upgrade-to/v6.mdx	Localization changed, will be marked as complete.
ja/reference/errors/client-address-not-available.mdx	Localization changed, will be marked as complete.
ja/reference/errors/no-matching-renderer.mdx	Localization changed, will be marked as complete.
ja/reference/publish-to-npm.mdx	Localization removed, will be marked as missing.
ja/tutorial/6-islands/1.mdx	Localization changed, will be marked as complete.
ko/concepts/why-astro.mdx	Localization changed, will be marked as complete.
ko/getting-started.mdx	Localization changed, will be marked as complete.
ko/guides/cms/index.mdx	Localization changed, will be marked as complete.
ko/guides/content-collections.mdx	Localization changed, will be marked as complete.
ko/guides/dev-toolbar.mdx	Localization changed, will be marked as complete.
ko/guides/framework-components.mdx	Localization changed, will be marked as complete.
ko/guides/integrations-guide/alpinejs.mdx	Localization changed, will be marked as complete.
ko/guides/integrations-guide/cloudflare.mdx	Localization changed, will be marked as complete. 🔄️
ko/guides/integrations-guide/index.mdx	Localization removed, will be marked as missing.
ko/guides/integrations-guide/markdoc.mdx	Localization changed, will be marked as complete.
ko/guides/integrations-guide/mdx.mdx	Localization changed, will be marked as complete.
ko/guides/integrations-guide/netlify.mdx	Localization changed, will be marked as complete.
ko/guides/integrations-guide/partytown.mdx	Localization changed, will be marked as complete.
ko/guides/integrations-guide/preact.mdx	Localization changed, will be marked as complete.
ko/guides/integrations-guide/react.mdx	Localization changed, will be marked as complete.
ko/guides/integrations-guide/sitemap.mdx	Localization changed, will be marked as complete.
ko/guides/integrations-guide/solid-js.mdx	Localization changed, will be marked as complete.
ko/guides/integrations-guide/svelte.mdx	Localization changed, will be marked as complete.
ko/guides/integrations-guide/vercel.mdx	Localization changed, will be marked as complete.
ko/guides/integrations-guide/vue.mdx	Localization changed, will be marked as complete.
ko/guides/middleware.mdx	Localization changed, will be marked as complete.
ko/guides/migrate-to-astro/from-gatsby.mdx	Localization changed, will be marked as complete.
ko/guides/migrate-to-astro/from-nextjs.mdx	Localization changed, will be marked as complete.
ko/guides/migrate-to-astro/from-nuxtjs.mdx	Localization changed, will be marked as complete.
ko/guides/migrate-to-astro/from-pelican.mdx	Localization changed, will be marked as complete.
ko/guides/on-demand-rendering.mdx	Localization changed, will be marked as complete.
ko/guides/troubleshooting.mdx	Localization changed, will be marked as complete.
ko/guides/upgrade-to/v3.mdx	Localization changed, will be marked as complete.
ko/guides/upgrade-to/v4.mdx	Localization changed, will be marked as complete.
ko/guides/upgrade-to/v5.mdx	Localization changed, will be marked as complete.
ko/install-and-setup.mdx	Localization changed, will be marked as complete.
ko/recipes/making-toolbar-apps.mdx	Localization changed, will be marked as complete.
ko/reference/cli-reference.mdx	Localization changed, will be marked as complete.
ko/reference/configuration-reference.mdx	Localization changed, will be marked as complete.
ko/reference/content-loader-reference.mdx	Localization changed, will be marked as complete.
ko/reference/errors/client-address-not-available.mdx	Localization changed, will be marked as complete.
ko/reference/errors/no-matching-renderer.mdx	Localization changed, will be marked as complete.
ko/reference/integrations-reference.mdx	Localization changed, will be marked as complete.
ko/reference/modules/astro-app.mdx	Localization changed, will be marked as complete.
ko/reference/publish-to-npm.mdx	Localization removed, will be marked as missing.
ko/tutorial/6-islands/1.mdx	Localization changed, will be marked as complete.
pl/concepts/why-astro.mdx	Localization changed, will be marked as complete.
pl/getting-started.mdx	Localization changed, will be marked as complete.
pl/guides/cms/index.mdx	Localization changed, will be marked as complete.
pl/guides/dev-toolbar.mdx	Localization changed, will be marked as complete.
pl/guides/upgrade-to/v4.mdx	Localization changed, will be marked as complete.
pl/install-and-setup.mdx	Localization changed, will be marked as complete.
pt-br/concepts/why-astro.mdx	Localization changed, will be marked as complete.
pt-br/getting-started.mdx	Localization changed, will be marked as complete.
pt-br/guides/cms/index.mdx	Localization changed, will be marked as complete.
pt-br/install-and-setup.mdx	Localization changed, will be marked as complete.
pt-br/recipes/making-toolbar-apps.mdx	Localization changed, will be marked as complete.
pt-br/reference/errors/client-address-not-available.mdx	Localization changed, will be marked as complete.
pt-br/reference/errors/no-matching-renderer.mdx	Localization changed, will be marked as complete.
pt-br/reference/publish-to-npm.mdx	Localization removed, will be marked as missing.
pt-br/tutorial/6-islands/1.mdx	Localization changed, will be marked as complete.
ru/concepts/why-astro.mdx	Localization changed, will be marked as complete.
ru/getting-started.mdx	Localization changed, will be marked as complete.
ru/guides/dev-toolbar.mdx	Localization changed, will be marked as complete.
ru/guides/on-demand-rendering.mdx	Localization changed, will be marked as complete.
ru/guides/upgrade-to/v3.mdx	Localization changed, will be marked as complete.
ru/guides/upgrade-to/v4.mdx	Localization changed, will be marked as complete.
ru/guides/upgrade-to/v5.mdx	Localization changed, will be marked as complete.
ru/install-and-setup.mdx	Localization changed, will be marked as complete.
ru/reference/errors/client-address-not-available.mdx	Localization changed, will be marked as complete.
ru/reference/errors/no-matching-renderer.mdx	Localization changed, will be marked as complete.
ru/reference/integrations-reference.mdx	Localization changed, will be marked as complete.
ru/tutorial/6-islands/1.mdx	Localization changed, will be marked as complete.
zh-cn/concepts/why-astro.mdx	Localization changed, will be marked as complete.
zh-cn/getting-started.mdx	Localization changed, will be marked as complete.
zh-cn/guides/cms/index.mdx	Localization changed, will be marked as complete.
zh-cn/guides/content-collections.mdx	Localization changed, will be marked as complete.
zh-cn/guides/dev-toolbar.mdx	Localization changed, will be marked as complete.
zh-cn/guides/framework-components.mdx	Localization changed, will be marked as complete.
zh-cn/guides/integrations-guide/alpinejs.mdx	Localization changed, will be marked as complete.
zh-cn/guides/integrations-guide/index.mdx	Localization removed, will be marked as missing.
zh-cn/guides/integrations-guide/markdoc.mdx	Localization changed, will be marked as complete.
zh-cn/guides/integrations-guide/mdx.mdx	Localization changed, will be marked as complete.
zh-cn/guides/integrations-guide/netlify.mdx	Localization changed, will be marked as complete.
zh-cn/guides/integrations-guide/partytown.mdx	Localization changed, will be marked as complete.
zh-cn/guides/integrations-guide/preact.mdx	Localization changed, will be marked as complete.
zh-cn/guides/integrations-guide/react.mdx	Localization changed, will be marked as complete.
zh-cn/guides/integrations-guide/solid-js.mdx	Localization changed, will be marked as complete.
zh-cn/guides/integrations-guide/svelte.mdx	Localization changed, will be marked as complete.
zh-cn/guides/integrations-guide/vercel.mdx	Localization changed, will be marked as complete.
zh-cn/guides/integrations-guide/vue.mdx	Localization changed, will be marked as complete.
zh-cn/guides/media/index.mdx	Localization changed, will be marked as complete.
zh-cn/guides/middleware.mdx	Localization changed, will be marked as complete.
zh-cn/guides/migrate-to-astro/from-gatsby.mdx	Localization changed, will be marked as complete.
zh-cn/guides/migrate-to-astro/from-nextjs.mdx	Localization changed, will be marked as complete.
zh-cn/guides/migrate-to-astro/from-nuxtjs.mdx	Localization changed, will be marked as complete.
zh-cn/guides/migrate-to-astro/from-pelican.mdx	Localization changed, will be marked as complete.
zh-cn/guides/on-demand-rendering.mdx	Localization changed, will be marked as complete.
zh-cn/guides/troubleshooting.mdx	Localization changed, will be marked as complete.
zh-cn/guides/upgrade-to/v3.mdx	Localization changed, will be marked as complete.
zh-cn/guides/upgrade-to/v4.mdx	Localization changed, will be marked as complete.
zh-cn/guides/upgrade-to/v5.mdx	Localization changed, will be marked as complete.
zh-cn/install-and-setup.mdx	Localization changed, will be marked as complete.
zh-cn/recipes/making-toolbar-apps.mdx	Localization changed, will be marked as complete.
zh-cn/reference/cli-reference.mdx	Localization changed, will be marked as complete.
zh-cn/reference/configuration-reference.mdx	Localization changed, will be marked as complete.
zh-cn/reference/content-loader-reference.mdx	Localization changed, will be marked as complete.
zh-cn/reference/errors/client-address-not-available.mdx	Localization changed, will be marked as complete.
zh-cn/reference/errors/no-matching-renderer.mdx	Localization changed, will be marked as complete.
zh-cn/reference/integrations-reference.mdx	Localization changed, will be marked as complete.
zh-cn/reference/publish-to-npm.mdx	Localization removed, will be marked as missing.
zh-cn/tutorial/6-islands/1.mdx	Localization changed, will be marked as complete.
zh-tw/concepts/why-astro.mdx	Localization changed, will be marked as complete.
zh-tw/getting-started.mdx	Localization changed, will be marked as complete.
zh-tw/guides/cms/index.mdx	Localization changed, will be marked as complete.
zh-tw/install-and-setup.mdx	Localization changed, will be marked as complete.
src/content/nav/ar.ts	Localization changed, will be marked as complete.
src/content/nav/de.ts	Localization changed, will be marked as complete.
src/content/nav/en.ts	Source changed, localizations will be marked as outdated.
src/content/nav/es.ts	Localization changed, will be marked as complete.
src/content/nav/fr.ts	Localization changed, will be marked as complete.
src/content/nav/hi.ts	Localization changed, will be marked as complete.
src/content/nav/it.ts	Localization changed, will be marked as complete.
src/content/nav/ja.ts	Localization changed, will be marked as complete.
src/content/nav/ko.ts	Localization changed, will be marked as complete.
src/content/nav/pl.ts	Localization changed, will be marked as complete.
src/content/nav/pt-BR.ts	Localization changed, will be marked as complete.
src/content/nav/ru.ts	Localization changed, will be marked as complete.
src/content/nav/zh-CN.ts	Localization changed, will be marked as complete.
src/content/nav/zh-TW.ts	Localization changed, will be marked as complete.

Warnings reference

Icon	Description
🔄️	The source for this localization has been updated since the creation of this pull request, make sure all changes in the source have been applied.

[yanthomasdev]

Just doing a safety block here since we'll either i18nIgnore or use a @lunaria-track directive in this one.

[FredKSchott]

yea it wasn't so bad until the URL changed for the integration guide. @yanthomasdev WDYT? I can also keep using the URL of the old integration guide, which would minimize the number of changes needed to lunaria.

[yanthomasdev]

@FredKSchott there's no "changes" needed to Lunaria, we just need to give it a pointer to ignore all these link changes, so just adding @lunaria-track:src/content/nav/en.ts to the merge commit description. Just need to take some time to go through all files and make sure that's right

[delucis]

Adding a quick note before I forget that if this is the change we end up going with, we should spend a little more time thinking about the tutorial navigation.

Currently the tutorial is a single item in the left sidebar but after this PR it gets its own dedicated sidebar with each unit linked, but not subpages. Then, there’s some “duplicate” navigation UI in the “tutorial tracker”:

Feels like this might cause confusion, so we should think a bit about the UX here.

[ArmandPhilippot]

I didn't want to give an immediate answer, I wanted to give myself time to adjust to the change (maybe I'm not completely finished with that... 👀 ).

This is not AI generated 😀 , but I know I can be quite verbose sometimes so I think some headings might help to make it easier to scan. And if that seems overwhelming, feel free to read "To conclude" first. 😅

Tutorial relocation

I think the tutorial being more visible is a good thing because I saw some users on Discord asking how/where they can find a tutorial (did they check the documentation first though?). But, as Chris pointed out this needs a bit more thinking.

Merging "Publish to npm" with "Working with Integrations"

I'm a bit concerned about the "Publish to npm" and "Working with Integrations" merge. But maybe this is just a me thing! This sounds a bit weird to me when I read the following:

## Publishing Your Integration to npm

Publishing an Astro component is a great way to reuse your existing work across your projects

In my head, "integrations" are kinda plugins for Astro and components are something different.

I know this was in the "Integrations" tab before but this didn't felt natural to me. However, because the page title was "Publish to npm" (ie. kinda generic) this made some sense.

Now, reading the first sentence under this heading feels even more wrong to me. I still think "Publish to npm" as a separate page made sense. And maybe, this shouldn't be tied to integrations given the contents.

I saw some people on Discord asking how to share their components across repo or in a monorepo. Maybe "Publish to npm" wasn't visible enough for them and the page, as a standalone page, deserves to be more visible, not merged. And maybe this shouldn't be only about "publish to npm" but kinda "share your work" (well, not that, but something like that).

Overall feeling

I am not claiming that the current docs organization is perfect. If it were my website, I would organize some pages differently. For example, "Testing" is an important concept to me and I would put it in the same place as "Environment variables", not in "Third-party services"/"Ecosystem"... But, perhaps because I am not a native English speaker, I would say that I would more easily look for it in the "Third-party services" tab rather than in "Ecosystem".

But does the changes make life easier for everyone? That's more difficult to answer!
And, if we want to make more reorganization, we might need a wider range of feedback? Something like what was done for the v5 reorganization through T&D could be useful, but maybe using another format to gather more feedback.

A thing that bothers me a little

This is not necessarily related to this PR... and I know Chris might disapprove because this is tied to URLs and according to Hypertext Styles "Cool URIs don't change". 😄

For me, URLs are kinda breadcrumbs (ie. reading /en/guides/view-transitions I know I'm browsing/I'll go to the View transitions guide in English language). There were already inconsistencies before (because of previous changes), but I feel like they're even more noticeable now. (e.g. /basics, /concept, /guides, /recipes, and top-level URLs such as /upgrade-astro are all under "Guides").

If we plan to reorganize pages soon , I guess we shouldn't fix that... even if this is a bit confusing. 😅 And I know this is not easy to find permanent URLs when docs need to be reorganized quite often. So, this is more a "thing that bothers me" than a "thing that needs to be fixed".

(and so, I think the link renaming is a good thing! guides/integrations sounds cleaner to me than /guides/integrations-guide).

To conclude

I don't mind trying something different if this can help our users! Except my concern about "Publish to npm" and what Chris raised about the tutorial, this looks good to me.

The changes are pretty minimal if we disregard the link renaming. I didn't notice anything wrong! So, once Chris concerns is addressed (and if I'm the only one thinking this about "Publish to npm"), I think we can try that.

Well, nothing wrong, except in French... It seems some non-breaking spaces were replaced with regular spaces which means, using the same resolution, some users can see:

In the deploy preview	In the live docs

Punctuation marks should not be isolated on a new line. But, not something blocking. I can always update that after! 🫡

[FredKSchott]

Publishing an Astro component is a great way to reuse your existing work across your projects

I generally agree, I tried to change as little content as possible in this PR, just combined the two guides together to keep scope managable, so my guess is that that was just how the old guide was written. I didn't introduce that term.

Can you lead a re-write in a follow-up PR if you're interested? That way we can keep scope here small given everything else I'm changing, but then treat it more like an enhancement post-merge.

[ArmandPhilippot]

Yeah, I understand the intent to keep things small! Thanks for that!

My point was more... I'm not sure the merge is a good thing? Because the "Publish to npm" is not tied to integrations (according to my definition at least) but also addresses components published on npm. So, as it stands, I'm not sure how to improve the wording for a "Publishing Your Integration to npm" section. Everything under this heading is about publishing components to npm, not integrations.

I mean, either we need specific content for integrations here and we move the component-related content elsewhere (not sure where yet)... or a dedicated page for publishing on npm remains relevant.

But sure, if we can agree on what would be best, I don't mind making the changes afterwards!

[yanthomasdev]

Solved the merge conflicts for you @FredKSchott. There's a new broken link in French, though. @ArmandPhilippot could you take a look at that?

IMO, I think we should just remove the translated integrations.mdx and let translators do that in their own pace without the risk of AI having made any mistakes with the nuance of spacing and so on that is very relevant in a few languages.

Then, quick "how to use Lunaria directives" tutorial for the moment you want to merge this:

1. Click the "squash and merge" button DO NOT CLICK CONFIRM
2. In "extended description" paste the magical words in the first line: @lunaria-track:src/content/nav/en.ts;src/content/docs/en/guides/integrations.mdx (without the backticks)
3. Now you can be happy and click "confirm squash and merge"

failure to follow these steps will lead to forfeiting all your material goods to me. 🫡

[ArmandPhilippot]

Ah, yeah, that page was merged today. I couldn't fix that directly through Github so I pushed a commit, I hope you don't mind Fred!

[FredKSchott]

IMO, I think we should just remove the translated integrations.mdx and let translators do that in their own pace without the risk of AI having made any mistakes with the nuance of spacing and so on that is very relevant in a few languages.

done! removed the translated integrations.md files

[yanthomasdev]

Looking good now.

BEFORE MERGING, DO NOT FORGET:

1. Click the "squash and merge" button DO NOT CLICK CONFIRM
2. In "extended description" paste the magical words in the first line: @lunaria-track:src/content/nav/en.ts;src/content/docs/en/guides/integrations.mdx (without the backticks)
3. Now you can be happy and click "confirm squash and merge"