Open DanielFroehlich opened 4 years ago
Zusätzlich oder alternativ zu unseren docs in git? Wenn zusätzlich - das lastet uns die Bürde des doppelten Pflegens auf. Wenn alternativ - dann kann ich es nicht mehr offline pflegen, es gibt keine docs pull requests mehr, ...
Ich sehe momentan noch nicht den Vorteil?
Der Vorteil kommt mit schönen Sidebars um die Navigation zu versinfachen.
Wie wäre es dann eher mit einer github.io Seite: https://pages.github.com ? Da können wir dann auch schön floating TOCs machen: https://github.com/allejo/jekyll-toc wie z.B. hier: https://ministryofjustice.github.io/security-guidance/#moj-security--guidance
Ich habe unseren bisherigen DOKS content mal ins wiki kopiert: https://github.com/sa-mw-dach/manuela/wiki/BOOTSTRAP
So wirklich viel besser ist das nicht, es gibt out of the box keinen dynamischen nav page, damit ich sehe wo ich grad im langen dokument bin.