New Wiki
Contents
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. 
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.
To do
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.
What are the goals?
![/!\](/moin_static1911/modern/img/alert.png "/!\"){kind=small}
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.
People say...
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.
- 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.
- Actually, maybe we could switch to Sphinx. It's the technology that Python uses for its documentation.
Technology
What seems to be a viable option.
DokuWiki
- Simple deployment.
MoinMoin to DokuWiki converter (github.com/glensc/moin2doku)
MediaWiki
It's actively maintained and it has a huge extension ecosystem.
References
- Resources:
Disadvantages
- SPAM.
- Plugins are actually hard to use. People say it is not a plug and play experience.
- Deployment is not trivial.
Phabricator
https://reviews-dev.freebsd.org/w/
Features we need
|
MediaWiki |
Phabricator |
|||
Redesign of the FrontPage. |
|
|
|
|
|
Hierarchy support. |
|
|
|
|
|
A way to flush stale/misleading/untrue content. |
|
|
|
|
|
Permissions so that most of the pages could be publicly editable. |
|
|
|
|
|
A single account for contributors: no more separate accounts per service. |
|
|
|
|
|
Preview while editing. |
|
|
|
|
|
