hackforla / hackforla/knowledgebase-content
Create a Guide/Template: Documentation Technologies
- Vorherrschende Sprache
- Keine Sprachdaten
- Sterne
- 2
- Forks
- 1
- PR-Merge-Kennzahlen
- Keine gemergten PRs in 30 T.
Beschreibung
### Overview
We need to create a guide to making a storage for your documentation, therefore we will write a guide discussing different documentation technologies that are available.
### Action Items
The phases in the guide-making process are listed below. Each phase displayed in blue is linked to a wiki page with instructions on how to complete that phase. Open the wiki page in a new tab, copy the instructions for each part into the section labeled 'Tasks' at the bottom of this issue, and complete each task listed.
- [ ] [Gather Examples Solo](https://github.com/hackforla/guides/wiki/How-to-Gather-Examples:-Solo) (open in a new tab)
- [ ] [Gather Examples Collaboratively](https://github.com/hackforla/guides/wiki/Phase-2-%E2%80%90-Gather-Examples-Collaboratively)
- [ ] [Create a Guide Draft](https://github.com/hackforla/guides/wiki/How-to-Draft-a-Guide)
- [ ] If needed, create a template
- [ ] [Have your guide peer reviewed](https://github.com/hackforla/guides/wiki/Peer-Reviews-for-Guides)
- [ ] [Present your guide for leadership review](https://github.com/hackforla/guides/wiki/Submitting-Your-Guide-for-Leadership-Review)
### Resources/Instructions
Google Drive Folder for this Guide’s documents and shortcuts [0145 [DRAFT] Documentation Technologies ](https://drive.google.com/drive/folders/1qRmqiftHcz8Jn8Q417QlfV0SOQBVUFx3)
There are many different free documentation management systems. We use two at Hack for LA
1. GitHub Wiki: To use when your wiki is small
2. MkDocks: As your wiki grows it can become unmanageable. At this point we recommend asking for a documentation repo and installing MK docks.
1. check the project People Depot for examples
- GitHub Wiki: https://github.com/hackforla/peopledepot/wiki
- MkDocks wiki: https://hackforla.github.io/peopledepot/
### Projects to Check
### Tasks
- [ ] This is where you will copy instructions from the wiki page for the step you are currently on.
Beitragsleitfaden
Rechercherichtung
Start with the linked wiki instructions for gathering examples, drafting, peer review, and leadership review, then inspect the Google Drive folder for existing guide materials. The guide should compare available documentation technologies, use the listed GitHub Wiki and MkDocks examples, and complete the review and leadership phases.
Vom Indexierungsmodell aus dem Issue-Text verfasst.
Bewertung
- Tech-Stack
- github
- Bereich
- documentation
- Issue-Typ
- Dokumentation
- Schwierigkeit
- 5/5
- Geschätzter Aufwand
- Über eine Woche
- Aktivitätsstatus
- Veraltet
- Klarheit
- Muss geklärt werden
- Anfängerfreundlichkeit
- 25/100