Open source wiki engines, in general, tend to be closer to Ward Cunninghamâs key ideas, introduced in WikiWikiWeb . As such, many of them tend to embrace the tenets of minimal secrecy, uniform addressability, and flat namespace to a better degree than the proprietary alternatives.
Some of the most popular open source wiki engines include:
Name | Native Document Format | DocOps Automation |
---|---|---|
DokuWiki | DokuWiki markup | plug-in SDK (PHP), direct file system interaction with markdown files. |
MediaWiki | MediaWiki markup | extensions (PHP), REST APIs, and direct interaction with its MySQL database. |
Wiki.js | AsciiDoc (limited support), Markdown (CommonMark + GFM), HTML (to support content imported from legacy systems) | GraphQL API, custom modules (JavaScript) |
Twiki | TWiki markup | Proprietary SQL-like query language |
XWiki | XWiki markup | scripting (Groovy), Velocity templates, extension points (Java) |
DocOps Automation
Open source wiki engines, together with static site generators, are among the most DocOps-friendly documentation platforms. All of the documentation system facets (UI, templating, document loading, etc.) are under the DocOps engineerâs control.
In addition, the database management system is directly accessible by the DocOps engineer which makes it easier to read, create, and update documentation in bulk without the hassle ofâpotentiallyâclunky APIs which operate on one document at a time.
Limitations
While open source wiki engines excel in their ability to accommodate DocOps use cases, theyâunfortunatelyâsuffer from a number of weaknesses as far as the needs of the large enterprise are concerned:
© 2022-2024 Ernesto Garbarino | Contact me at ernesto@garba.org