eyk.github.io

Walter Seethaler

• Was ist ein zeitgemäßer Doku-Workflow?
• Typische Doku für Entwickler-Tools
  • https://code.visualstudio.com/docs
  • https://developer.hashicorp.com/packer/docs
  • GitHub-Pages (und GitHub-Actions)
    • https://github.com/eyk/eyk.github.io
      • Repository + Build-Prozess (Code-Generator) + statisches Webhosting
      • .
        • Bilder einfügen
        • Quelltext hervorheben
        • Veröffentlichungsvorgang vorführen
    • https://docs.github.com/en/pages/quickstart
• Beispiel von README-Dateien in VS Code
  • https://github.com/microsoft/vscode - Quelltext-Startseite
  • https://github.com/microsoft/vscode-docs - Doku-Quelltext-Startseite
  • Dokumentation
    • https://code.visualstudio.com/api
    • /api/index.md
  • Doku-Generator: https://docusaurus.io/showcase?tags=favorite
• Hugo
  • https://gohugo.io/hosting-and-deployment/hosting-on-github/
  • https://de.wikipedia.org/wiki/Hugo_(Software)
  • https://gohugo.io/documentation/
• GitHub-Pages
  • https://github.com/organizations/plan
  • https://github.com/settings/organizations
  • In Firefox anzeigen
• Workflow
  • Doku-Scope, Gliederung, Autor+Lektor, Content-Planung, Zeitplan
  • Import aus Confluence
• Übersetzung
  • Markdown: https://simpleen.io/blog/translate-markdown-files
  • DeepL: https://de.wikipedia.org/wiki/DeepL
  • Beispiel: https://www.sitefusion.de/en/solutions/
  • https://www.deepl.com/de/pro?cta=header-pro
  • Mehrsprachigkeit: https://gohugo.io/content-management/multilingual/

declare foo;
<foo></foo>