META - Documentation improvements (infra and workflows)

[pavithraes]

Docusaurus allows us to create landing pages, and provides a nice visual and functional user experience for the docs. For example, see Nebari docs update: https://www.nebari.dev/

From Tania:

If we move to Docusaurus we could even add the Storybook Docusaurus addon to keep all our docs in a single place

---

Tasks

Preview Give feedback

1. Set up Docusaurus docs site for conda-store - Set up Docusaurus #534
2. Set up docs framework - Restructure docs to use Diataxis #398
3. Integrate conda-store-ui docs with Storybook plugin #690
   area: documentation 📖 type: enhancement 💅🏼 +2
   
4. Update relevant repo files to point to new docs
5. [DOC] Add Playwright tests to grab relevant screenshots #570
   area: documentation 📖 needs: discussion 💬 +2
   
6. Deploy new docs - need to clarify, related: Setup Netlify for Docusaurus deployment #407
7. Remove old Sphinx docs (and dependencies) Remove Sphinx docs  #695
8. Update docs home page messaging+design - DOC - Update homepage to include project details #565
9. Update theme to match conda-store design
10. Update conda.store domain to point to Netlify docs #699
    +0
    
11. Close/delete RTD deployment for conda-store

[costrouc]

@pavithraes I am open to this but do appreciate the "simplicity" of sphinx. I feel this would be a lot of work to make that transition. That said I do think that the docusuarus generated pages are much nicer.

[trallard]

If we move to Docusaurus we could even add the Storybook Docusaurus addon to keep all our docs in a single place

[costrouc]

@pavithraes clould you write a status update on this?

[costrouc]

@smeragoel asked if it is possible to document design here as well?

[pavithraes]

@costrouc - this work was on hold for a while, picking it up this week. :)

@smeragoel asked if it is possible to document design here as well?

I don't fully understand the question here, could you please elaborate on this @smeragoel?
In case you mean should we track it here -- there is a task for design doc in #561 (tracking the actual content there) and the placeholder page is: https://github.com/conda-incubator/conda-store/blob/main/docusaurus-docs/community/design.md

[pavithraes]

I'm going to mark this META issue as complete. We do have the playwright tests task remaining, but we can track that in the corresponding issue. :)