New Wiki

Our MoinMoin wiki infrastructure is a little bit difficult to maintain. <:( oh no!

It's missing many important functionalities and does not serve the community to its full potential. X-( how awful! let's do something about it!

In order to revive this important productivity tool, which is a working and accessible wiki service, let's reevaluate how the FreeBSD wiki should be maintained and used in order to it a collaboration booster rather than a burden.

This idea came to be during a conversation with KubilayKocak.

• Ask WarrenBlock about what he was thinking of moving to.
• Ask Debian, Python and Bash folks if they are considering moving from MoinMoin as well.
  • MateuszPiotrowski contacted Debian wiki folks and they are happy with MoinMoin so far.

TODO

• Wiki for the whole FreeBSD community
  • A tool for the developers to make it easier to share ideas, cooperate, publish status reports.
  • A knowledge base for the users, which is less formal than FreeBSD handbooks.
• Wiki as a replacement for handbooks. FreeBSD changes very quickly and the current way of updating documentation is too slow to catch up.

• I find the current wiki hard to work with, it's hard to create separate sections and sub-pages and stuff and get an overview of what's there. I get the feeling it's possible to create pages with no links to other pages, which makes stuff very very hard to find.
• MateuszPiotrowski
  • Actually, maybe we could switch to Sphinx. It's the technology that Python uses for its documentation.
    • It's flexible.
    • It's easy to modify.

What seems to be a viable option.

• Simple deployment.

• MoinMoin to DokuWiki converter (github.com/glensc/moin2doku)

It's actively maintained and it has a huge extension ecosystem.

• MoinMoin to MediaWiki migration tool (github.com/0mp)
• Resources:
  • Skins (wikiapiary.com)
  • Extensions (www.mediawiki.org)

• SPAM.
• Plugins are actually hard to use. People say it is not a plug and play experience.
• Deployment is not trivial.

https://reviews-dev.freebsd.org/w/