2024 Q1 Planning - Team DX

# Planning Session ## Working Notes ### i18n story Starlight/Astro Docs - goal: Starlight is THE i18n docs framework (i18next)? - goal: unifying Astro Docs (smaller scope) - goal: refactor Starlight i18n to include our own i18n routing API - goal: incorporate Lunaria into Starlight (official plugin?) - updating docs for translators, process, instructions for using Lunaria Challenges: - some custom Astro components, infra use older i18n system - Starlight makes it easy to get UI strings; Astro docs doesn't - A more powerful API needed to take it to the `i18next` level? (e.g. look ups, storing lots of data) -- do we look at bundling an existing product? ### Adding new components from Astro docs into Starlight as built-in - FileTree - a good candidate because so often used, but often in crappy, hacky, inaccessible ways; - Multiple choice quiz - steal other components from other frameworks! (e.g. `<Steps />`) - good docs for building your own components? - Hideoo's page component (pre-dating plugin system) for injecting other non-Markdown routes "Virtual Pages" - customizing `<head>` solutions Challenges: - don't want to have to maintain/support too many components that people try to do weird things with - some make sense to include, some don't (IN-content make sense; ones that require overriding Starlight's layout don't make as much sense) ### Starlight Community Content - Community section in sidebar - Community recipes and official ones - show off showcase/plugins etc. ### Lunaria (& Starlight support) - User-facing docs for public beta - Improved onboarding with `create-lunaria` - `lunaria sync` for config autofilling of `locales` and `files` (Starlight included from day one) ### community.astro.build - public calendar people could add to (meetups, streams) - grant program page ### Community recipes/content more discoverable in/from docs - even our official recipes are a mess, let alone one big long link of external sources - don't have a great non-recipe community resource page (e.g. for people's video content, ebooks) - new content pages: e-commerce, auth, community curated resources _Elian Small Notes 👇_: __Possible New Stuff__ - e-mail newsletter - astro.build maintainance + themes & showcase - team UI stuff (_don't know how public we can be about this_) __Regular Stuff__ - 1 Community Call per week - 1 T&D per week - 1 Announcement post per week - 1 Blogpost per month - Community Awards every month - Maintain community.astro.build - Docs support where needed ----- ## Goals - Update/Unify Astro Docs and Starlight i18n (@Chris) - [ ] Astro/Starlight work the same-ish way - [ ] More robust Public API - stretch: Incorportate Astro i18n Routing API into Starlight (Docs) - [ ] Deliverable 3 - [ ] Deliverable 4 - Lunaria (& Starlight support) (@Yan) - [ ] Creating `lunaria sync` command - [ ] Public docs of main features/reference - [ ] Improved `create-lunaria` flow - Deliver more built-in Starlight components/plugins + guides for building own (@Chris/Hideoo/Otterlord) - [ ] Virtual Pages - [ ] FileTree etc. components - [ ] more guides - [ ] head content options/solutions (e.g. Open Graph, better API for adding head content) - Starlight Docs Community section (@Sarah) - [ ] Deliverable 1 - [ ] Deliverable 2 - Astro Docs Community section esp. handling recipes mess (@Sarah) - [ ] Deliverable 1 - [ ] Deliverable 2 ## Launch Week Candidate Proposals - a thing? ## Sprint 1 (January 8 - 19) - (person) Task - (person) Task - (person) Task - (person) Task - (person) Task - (person) Task - (person) Task - (person) Task - (person) Task - (person) Task - (person) Task ## Sprint 2 (January 22 - Feb 2) - (person) Task - (person) Task - (person) Task - (person) Task - (person) Task - (person) Task - (person) Task - (person) Task - (person) Task - (person) Task - (person) Task - 2 Feb - Elian at [Kongres NextJS](https://kongresnextjs.pl/), Warsaw, Poland - 3 Feb - Elian at [FOSDEM](https://fosdem.org/2024/), Brussels, Belgium ## Sprint 3 (February 5 - 16) - (person) Task - (person) Task - (person) Task - (person) Task - (person) Task - (person) Task - (person) Task - (person) Task - (person) Task - (person) Task - (person) Task ## Sprint 4 (February 19 - March 1) - (person) Task - (person) Task - (person) Task - (person) Task - (person) Task - (person) Task - (person) Task - (person) Task - (person) Task - (person) Task - (person) Task - 28 Feb - 1 March - Elian at [Devworld Conference](https://jsworldconference.com/), Amsterdam, The Netherlands ## Prep/Launch Sprint ### Prep week (March 4 - 8) ### Launch Week (March 11 - 15)