BLUEPRINT for documentation website

Site https://doc.Asqatasun.org

• https://doc.Asqatasun.org/v4 is Static HTML grabbed from old doc site
• https://doc.Asqatasun.org/vX (X > 4), is generated by Hugo
• https://doc.Asqatasun.org/en/(.*) is redirected to /v4/en/$1

Repositories

Documentation-v4

• Content is is static HTML
• CI: rsync to https://doc.Asqatasun.org/v4

Documentation

• Content is Markdown (to fill in Hugo)
• CI: Hugo generation + rsync to https://doc.Asqatasun.org/vX (X > 4)

Versions of documentation

• For /v4/, add (in navigation) a hardcoded link to a page listing all versions of doc
• For /vX/, create something similar leveraging Hugo

Progress

• Place v4 doc on server
• Set up redirection in Apache: https://doc.Asqatasun.org/en/(.*) is redirected to /v4/en/$1
• Generate v5 doc and place on server with CI
• Create a homepage for https://doc.Asqatasun.org/ welcoming user + listing versions of docs