Using Wikis to Share Knowledge¶

Wikis are a widely-used tool for collaboration, allowing team members to create and edit articles that document a project, a group of projects, or more.

Create Your First Article¶

Every project in Dataiku DSS is wiki-enabled. To create your first article:

Go to the Wiki section of the navigation bar and click +Create Your First Article
In the New article dialog, give the article a name. For the moment, we can call it README to signal that this is the wiki article team members should start reading.
Since this is our first article, choosing the Sample wiki article template will provide us with a helpful outline and markdown examples.
Click Create.

Edit Your Article¶

Dataiku DSS supports Markdown and HTML/CSS for formatting wiki articles. In Edit mode, the controls along the top of the edit area and the sample text should get us through common formatting options, and we can consult the reference documentation for details on Dataiku markdown support.

One feature worth calling out specially is the ability to reference Dataiku DSS objects within the wiki. You need to provide the name of the project that contains the object, the type of object, and then the name of the object itself. This creates a link in the finished wiki that teammates can follow.

The Actions menu allows you to:

Set home article. This is the article displayed first when you visit the wiki.
Change parent article. This changes the hierarchy of the wiki to place this article at the top level of the wiki or as the child of another article.
Switch to article/folder layout. “Article” layout displays the article text with a list of attachments in the right panel. “Folder” layout displays the list of attachments below the article text, and the article can be expanded/collapsed for reading.
Rename. Rename the article at any time. Take care, though, since this will break existing links to the article.