📝 Docs - Document Gatsby + Tina

[bradystroud]

There are already some old, half-baked Gatsby docs and we are writing some new ones.

• Make sure existing docs are up to date
• Look at all the Gatsby docs
• Structure - work out where new pages should go
• Create a list of pages we could write based on the knowledge we gained

Acceptance Criteria

Have a plan of what the docs should look like.
e.g. what items will be in the ToC and where

[isaaclombardssw]

Pre-existing Gatsby Content on Tina.io

1. A number of blog posts (all 2+ years old, not longer relevant)
   --> should we write a new one on getting Gatsby working (assuming Hugo + Gilles starter goes smoothly) + the process behind creating it?
   Note: these's are also only accessible by direct link and have been marked as depreciated, so no change needed on our part as this is ideal status for em.

ex. https://tina.io/blog/creating-markdown-drafts

⏸ No action needed.

2. Updated docs | frameworks | Gatsby – for correctness. Still need to link to the gatsby conversion guide (“for a more detailed tutorial, see …”).
   https://tina.io/docs/frameworks/gatsby
   Updating this is currently in the works - see Hugo’s PR Update gatsby.mdx tinacms/tina.io#2412.

🚧 WIP.

3. The Gatsby examples under the Image Field has some Gatsby image formatting – I believe it’s not totally up to date, using ‘fluid’ images which have been depreciated.
   We should also move this kind of info elsewhere.

• PBI 📝 Docs – Old Gatsby Content tinacms/tina.io#2416

ex. https://tina.io/docs/reference/toolkit/fields/image#proper-image-paths-in-gatsby

✅ Done.

4. Caleb’s guide – converting Gatsby to Tina.io… this will need to be updated to the better way (see Hugo and Gilles starter) as it is possible to get visual editing working.
   There’s some caveat Hugo mentioned about the header being too permissive.
   Do we need to add a warning callout for this? Also these two guides should be co-located in the ToC somehow.

• PBI for this rework 📝 Framework Guides + Gatsby Migration Guide – v2 – Visual Editing Enabled tinacms/tina.io#2417.

🛑 Awaiting consensus on the starter – are we promoting that approach?

What to add

1. Blog posts – we should we write a new one on getting Gatsby up and running (assuming Hugo + Gilles starter goes smoothly) with Tina again, many systems still live on Gatsby, etc. etc. – and how we we’re committed to improving Tina with xyz.

It would be a good place to bring attention to the new docs pages and starter.

🤔 TBC – is this a good idea?

2. As per a conversation with Landon, frameworks each have their own page such as https://tina.io/hugo-cms and https://tina.io/nextjs-cms – they mostly exist for google juice (they need to be audited and reworked visually).

Gatsby should have a similar page.

• PBI for the Gatsby page 📝 New Framework Page – Gatsby tinacms/tina.io#2415.
• PBI for reworking these kinds of pages 📝 Updating Framework-Specific Pages tinacms/tina.io#2394.

🛑 Awaiting consensus on the starter – are we promoting that approach?
🔺 Vercel preview – https://tina-dkedqx55z-tinacms.vercel.app/gatsby-cms/

3. As per a conversation with Landon, framework page to help people choose a framework – at least a blog post but Landon and I think a resource page (and we can link to all the weird offshoot pages in (2)).

• PBI for the framework comparison 📝 New Page – Framework Comparison tinacms/tina.io#2393.

🆕 PBI exists, to be completed.

[isaaclombardssw]

As the above comment – I've updated some Gatsby content on Tina.io, and created PBIs for future work related to this.

Statuses are correct as per the last edit date of the that comment.

Closing this issue 👍