====== New Wiki ======

Our [[/MoinMoin|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|KubilayKocak]].//

===== To do =====

  * Ask [[/WarrenBlock|WarrenBlock]] about what he was thinking of moving to.
  * Ask Debian, [[https://wiki.python.org/moin/FrontPage|Python]] and Bash folks if they are considering moving from [[/MoinMoin|MoinMoin]] as well.
    * [[/MateuszPiotrowski|MateuszPiotrowski]] contacted Debian wiki folks and they are happy with [[/MoinMoin|MoinMoin]] so far.

===== What are the goals? =====

:!: 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.//
  * [[/MateuszPiotrowski|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.

===== Technology =====

What seems to be a viable option.

==== DokuWiki ====

  * Simple deployment.

  * [[https://github.com/glensc/moin2doku|MoinMoin to DokuWiki converter (github.com/glensc/moin2doku)]]

==== MediaWiki ====

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

==== References ====

  * [[https://github.com/0mp/moinmoin2mediawiki|MoinMoin to MediaWiki migration tool (github.com/0mp)]]
  * Resources:
    * [[https://wikiapiary.com/wiki/Skin:Skins|Skins (wikiapiary.com)]]
    * [[https://www.mediawiki.org/wiki/Category:All_extensions|Extensions (www.mediawiki.org)]]

=== 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 =====

|  | **[[/MoinMoin|MoinMoin]]** | **%%MediaWiki%%** | **Phabricator** | **[[http://www.sphinx-doc.org/en/master/|Sphinx]]** | **[[https://gohugo.io/|Hugo]]** |

| Redesign of the [[/FrontPage|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. |  |  |  |  |  |

----

{{tag>Wiki}}