[EPIC] Editor guide: how to contribute content and datasets

[rufuspollock]

Create a first editor guide for adding and editing conten to a markdown-based site -- specifically a markdown-based, flowershow-published site and even more specifically a "MOGF" (markdown-obsidian-github-flowershow built site).

Outcome visioning 🎯 (High level acceptance)

A non-dev editor/author at Life Itself or anywhere else has a single online place to go to with (or linking to) sufficient docs to autonomously (i.e. without dev support) ...

• Edit lifeitself.org
  • Create a new blog post
  • Create a new page
  • Edit a blog post or page
• Create, share and publish a micro-catalog
  • Create locally
  • Share with others (privately)
  • Publish
• Create a digital knowledge garden i.e. content + catalogs etc

Plan of work

Prep

Tasks

Beta Give feedback

1. Merge in (and then close as duplicate) Tutorial for editing our websites: git + markdown/obsidian + flowershow life-itself/community#519 ✅2023-05-24
2. Merge in and then close https://github.com/orgs/life-itself/discussions/393 ✅2023-05-24
3. Define editing tools / process ✅2023-06-06 we will use the same stack we are documenting! i.e. MGF (markdown, github, flowershow)
4. ➕2023-06-06 Review and tidy existing epic [EPIC] Editor guide: how to contribute content and datasets #1 ✅2023-06-06 split out job stories task, tidied up acceptance and tasks
5. Outline purpose of consolidated guide and define acceptance ✅2023-06-06 good enough for now. see SCQA above + purpose and principles in 🗄️ "Catalogs of Stuff" Docu-thon: or How to build markdown-based sites using Flowershow / PortalJS datahub#927 (may need some refinement and consolidation here)
6. Instructions on how to create documentation ✅2023-06-06 see Process for creating documentation: some recommendations datahub#929
7. Job stories for editor guide(s) (what 'How to...?' questions are wanting to be answered?) #4
   duplicate +1
   
8. Editor guide: Review and recommend for integration existing polished documentation #5
   documentation +1
   
9. Decide where we publish ✅2023-12-14 publish on makeitmarkdown

Content

https://coggle.it/diagram/ZG5bpZ-I6DjyVLxZ/t/editor-guide-latest-this-part-is-initial-2023-5-24-14-01

• Tutorial for each job story - first skeleton, then flesh out etc as per #929 💬2023-06-07 topic and skeleton mega coggle - https://coggle.it/diagram/ZG5bpZ-I6DjyVLxZ/t/editor-guide-latest-this-part-is-initial-2023-5-24-14-01
• Tutorial: "How to create a data catalog out of markdown files using free tools?" datahub#936

Misc

• Reference from any other locations e.g. life itself tao, datopian playbook etc
• Deprecate any existing guides in favour of this if possible

[rufuspollock]

UPDATE: 2023-11-01

• we made a lot of progress on this in June 2023 with (some of the) results published at https://portaljs.org/guide.
• also clear we need to do better "shaping" of this project to be clearer on what to ship for our given appetite

Current outstanding work

• [The Guide] Tutorial 3: Collaboration
• [The Guide] Tutorial 4: Website configurations

Sketch of the Guide

• Please do Tutorial 1: "Creating your own sandbox website from scratch using markdown and PortalJS/Flowershow"
  • By the end of that you should have achieved / know how to?
    • Markdown ...
    • Create a new blog post
    • Edit a page via the UI ...
• Please do Tutorial 2: "Editing your own website locally with Obsidian"
• Please read Tutorial 3: Collaborating (aka "Git and Collaboration ...")
• Tutorial 4: Website-y stuff e.g. navbars, footers, etc etcc
• Now, read this step-by-step "howto" on how to edit the life itself website