Continuing to use Dokuwiki has a couple of large downsides:
Collaborating on changes is difficult. It's much easier for people to suggest changes via github.
Editing is slow and painful. Although the syntax is probably more powerful that markdown, markdown is significantly easier to edit.
Only people with php.net can edit documents, which means that community members who do not have php.net accounts basically can't suggest changes.
- Figure out what is a good alternative.
- Figure out how we can generate CSS that maintains the PHP.net brand - this is handled in theme repository
- Make a list of what pages should be kept from: PHP Wiki Index
- Convert DokuWiki to Markdown documents using this tool (remember to include Frontmatter data, generated files may need some cleaning in tags)
This repository needs Hugo installed locally to build and server static files. Follow the installation guide instructions.
Docker image can be also used if you don't want to install Hugo locally
then running commands through make will use Hugo through Docker container.
Creating new content of type RFC (these are called Archetypes
in Hugo - the template is in /theme/php/archetypes/rfc.md):
make new name=rfc/[rfc-name].mdPossible archetypes to use: rfc, page
Building and serving static files:
make serve