Andre has set up a great HTML prototype of the Dev Portal at people.wikimedia.org. The Dev Portal prototype will be our most important content strategy tool over the next few months, so I'd like to spend some time as a group thinking about our requirements for it and how we can maintain it going forward. This prototype will be purely for content development and user testing, so it doesn't need to be blocked by the technical investigation phase.
Requirements (WIP):
- Can be modified by Andre, Alex, and Sarah R
- Can be maintained through a code review process
- Somewhat mimics the Dev Portal's final design by using Wikimedia styles and standard web components
- Can be accessed publicly in a browser
- Not too much initial effort to set up
Options to discuss (WIP):
- people.wikimedia.org
- According to Wikitech, this requires shell access in production to update?
- Toolforge for hosting
- GitHub for source control
- a Vue site
- Is this overkill for our needs? How much work would it be to set this up?
- Possibility to leverage wvui
- a VuePress static site
- Something like this theme could work well for us
- I think I remember Bryan saying that JavaScript wasn't a good fit for a static site :)
- a Hugo static site
- Example of a documentation theme
- Hugo would be my top choice for a non-Vue static site generator