--- layout: markdown_page title: "Category Direction - Wiki" --- - TOC {:toc} ## Wiki | | | | --- | --- | | Stage | [Create](/direction/create/) | | Maturity | [Viable](/direction/maturity/) | | Content Last Reviewed | `2020-03-27` | ### Introduction and how you can help Thanks for visiting the Wiki category direction page in GitLab. This page belongs to the [Knowledge](/handbook/product/categories/#knowledge-group) group of the Create stage and is maintained by Christen Dybenko ([E-Mail](mailto:cdybenko@gitlab.com)). This strategy is a work in progress, and everyone can contribute: - Please comment and contribute in the linked [issues](https://gitlab.com/groups/gitlab-org/-/issues?scope=all&utf8=%E2%9C%93&state=opened&label_name%5B%5D=Category%3AWiki) and [epics](https://gitlab.com/groups/gitlab-org/-/epics?scope=all&utf8=%E2%9C%93&state=opened&label_name[]=Category%3AWiki) on this page. Sharing your feedback directly on GitLab.com is the best way to contribute to our strategy and vision. - Please share feedback directly via email, Twitter, or on a video call. If you're a GitLab user and have direct knowledge of your need for Wiki, we'd especially love to hear from you. ### Overview GitLab Wikis are a great way to share documentation and organize information via built-in functionality. Each GitLab project includes a Wiki rendered by [Gollum](https://github.com/gollum/gollum), and backed by a Git repository. **Walkthrough of GitLab wikis (starts at 9 minutes):**
### Where we are Headed In 2020 we'll be tackling Group Level Wikis which will give our organizations the ability to collaborate in a shared wiki that spans multiple projects. (This is currently the most upvoted issue on GitLab!) We will also be tackling issues around markdown rendering and tidying up navigation in the Wiki. As we look to future plans beyond 2020, we will be aiming for real time WYSIWYG collaboration (similar to Google Docs). This would solve the problem of collaborative note taking, be highly approachable for non-technical users, but have the tremendous benefits of storing the content in a portable plain text format that can be cloned, viewed and edited locally (properties of Git). ### Target Audience and Experience * All personas can use Wikis for storing information * We may need to investigae a non-technical persona as our reserach found they are often users of wikis ### What's Next & Why **Next: [Group level wiki](https://gitlab.com/groups/gitlab-org/-/epics/240)** - Currently wiki's are only on the project level. Next we are movoing them to Group level and making them container agnostic so we can expand on this and add them as a Global Wiki. Currently we are working on: - [MVC 1: to support one wiki at Group Level](https://gitlab.com/groups/gitlab-org/-/epics/2214) - [MVC 2: Feature parity with project](https://gitlab.com/groups/gitlab-org/-/epics/2782) **Next: [Improve AsciiDoc, RDoc and reStructuredText](https://gitlab.com/groups/gitlab-org/-/epics/701)** - Many of our custmoers rely on specific formats to support their wikis. We should make sure our wiki's suppport these formats so that they can use their Group Level wikis as a company. **After: [Simplify wiki editing](https://gitlab.com/groups/gitlab-org/-/epics/204)** - Currently wiki editing is inconsistent with every other page, both visually and from a workflow perspective. This makes wiki less approachable for users familiar with the rest of GitLab. We should fix these inconsistencies as a priority. **After: [Improve wiki navigation](https://gitlab.com/groups/gitlab-org/-/epics/700)** - As wikis grow with more and more content, GitLab is not providing the tools necessary to make them easy to navigate and use. This is a problem that can be resolved with support for macros and a few other small improvements. **Later: [Deeper integration of wikis with GitLab](https://gitlab.com/groups/gitlab-org/-/epics/699)** Once the immediate useability is addressed by the epics above, next we make sure that Wiki's can embed Issues, Designs or display other objects from GitLab. ### What is Not Planned Right Now Right now, we are not working on WYSIWYG and Live Editing, but instead setting the stage with our architecture and cleaning up the existing experience. We expect to dive into editing features later in 2020. ### Maturity Plan This category is currently at the Viable maturity level, and our next maturity target is 2021 (see our [definitions of maturity levels](https://about.gitlab.com/handbook/product/categories/maturity/#legend)). ### Competitive Landscape We currently most closely compete with **GitHub Wikis** but we would like to compete with: - [Confluence](https://www.atlassian.com/software/confluence) - [Notion](https://www.notion.so/) - Google Docs ### Analyst Landscape TBD ### Top Customer Success/Sales issue(s) - [Group Level Wiki](https://gitlab.com/groups/gitlab-org/-/epics/240) - [Improve AsciiDoc, RDoc and reStructuredText support in Wikis](https://gitlab.com/groups/gitlab-org/-/epics/701) ### Top user issue(s) - [Add Group level Wiki](https://gitlab.com/gitlab-org/gitlab/issues/13195) (590) - [Allow org-mode in Wiki](https://gitlab.com/gitlab-org/gitlab/issues/19688) (180) - [Markdown Export to PDF](https://gitlab.com/gitlab-org/gitlab/issues/13932) (166) - [Reflect next pages in sidebar](https://gitlab.com/gitlab-org/gitlab/issues/17673) (144) - [Update wiki page (.wiki.git) from CI](https://gitlab.com/gitlab-org/gitlab/issues/16261) (133) - [Diff functionality in Wiki](https://gitlab.com/gitlab-org/gitlab/issues/15242) (132) ### Top internal customer issue(s) Due to the current state of Wikis they are not used internally. ### Top Strategy Item(s) - [Live editing](https://gitlab.com/groups/gitlab-org/-/epics/820)