Dokument
Stránky, které na něco ukazují.
Živé dokumenty propojené se systémem, který popisují — navázané na vaše soubory, prolinkované s diagramy a platné i za měsíc.
01
Navázané na vaše soubory
Stránku lze navázat na soubor v repozitáři, i se zdrojem a revizí, takže se dá obnovit, když se soubor změní — nebo do něj zapsat zpátky.
- Navázaná na soubor — stránka ví, ze kterého souboru pochází a na jaké je revizi.
- Obnova po úpravách — změňte soubor, obnovte stránku a nástěnka to dožene.
- Zápis zpátky — tok jde i opačně: upravte na nástěnce, zapište do souboru, commitněte.
02
Rovnou na uzel
Odkažte odstavec přímo na prvek diagramu, který vysvětluje, aby se text a obrázek přestaly rozcházet.
- Odstavec na uzel — odkaz přistane na konkrétním prvku, ne na diagramu obecně.
- Oběma směry — diagram odkazuje zpět na stránku, takže cestou dovnitř je obojí.
03
Jeden zdroj, dva domovy
Stejný text slouží nástěnce i dokumentaci, takže nikdo neudržuje druhou kopii, která postupně přestane sedět s první.
- Nástěnka i repozitář — jeden dokument, dostupný z obou stran.
- Markdown — stránky se skládají v markdownu, ne v uzavřeném formátu.