The FogBugz Wiki is a useful tool for creating and maintaining documentation.
A wiki is a collection of related articles. For example, you might have one wiki called “Employee Handbook” with separate articles for your vacation policy, expense policy, and parental leave policies. You might devote a separate wiki to internal documentation about your product, with one article for your deployment process, one article outlining your system architecture, and one outlining your product’s guiding principles.
You can create as many wikis as you need and use them for any team documentation: specifications, requirements documents, knowledgebase articles, status reports, internal technical documentation, and external end-user documentation. Because anyone can edit any article, the quality of each article will improve over time.
Learn more about wiki functionalities in this article below:
- Creating a New Wiki
- Creating a New Wiki Article
- Editing a Wiki Article
- Wiki Article Information
- Searching Wiki Articles
Creating a New Wiki
To create a new wiki, visit Wiki > Manage Wikis, then click New Wiki. You will see an editor for your Wiki’s root article, which should generally be an overview that introduces the entire wiki.
Review the article Creating a Wiki for instructions.
Creating a New Wiki Article
There are a few ways to create a new wiki article. First, you can click New Article from the wiki menu to the left of any wiki. One of the advantages of a wiki is that it links between wiki articles to help emphasize interconnected topics. We have also made it possible to create a new wiki while you are editing an existing article. Click where you want to create a hyperlink to the new article, and select Insert | New Article. A new, initially-blank, article is created while in the current document. The link will be a red color to remind you that the new article has not been written yet. Save your changes and click on the red link to get to the new article.
Editing a Wiki Article
Each wiki article can be edited by anybody by default (you can more narrowly define your permissions if required), allowing anyone to improve an article by clicking the Edit link and editing it in place.
NOTE: A complete record of all edits is maintained forever.
Here is some information on editing different elements.
In general, when you want to insert a link:
- Type the text that the link should have, and select it.
- Choose Insert | Link.
- Enter the destination that the link should go to.
The wiki is tightly integrated with FogBugz. You can create a link to any FogBugz case by merely typing the case number when you insert a link. This becomes a bidirectional link; the FogBugz case will link back to the wiki article automatically. Likewise, you can link from a case to a wiki page by typing w and the article number when editing the case, for example,
You can also attach a file to a wiki article and create a link to it in one step by clicking Insert | Attachment...
Images and Tables
For more information, read the article Adding Images and Tables to Wiki Articles.
NOTE: You can also insert an automatically-updating table of contents for an article with the Wiki Table of Contents plugin.
FogBugz does not automatically maintain a table of contents to all wiki articles. If you delete the last link to a given article, even though it still exists in FogBugz, you can only get to it by directly typing the URL. This is called an orphaned article; administrators can see a list of them in the wiki configuration page. To delete an article, remove all links to it (see the article’s Info page for a list) and then delete it from the orphaned articles list.
NOTE: A template applies to all articles within each wiki.
If you want to change the fonts, styles, and colors used in your articles, just select a new template. To do so, choose Wiki | Manage Wikis… to navigate to the Wikis page, then click the Configure icon next to your wiki's entry in the list. This will take you to the Edit Wiki page, where you can select a template.
To edit an existing template, click on the Customize Templates link at the bottom of the Wikis page. On the Templates page, click the Configure icon next to a template’s entry in the list.
The Edit Template page allows you to:
- Customize page layout HTML.
- View a set of template variables that you can embed in your wiki (for example, the “
$incoming_links$” variable lists all pages that link to the current page).
- Edit the wiki's CSS stylesheet, and specify a set of image (or other content types) attachments for use in your layout HTML.
The FogBugz Wiki is completely multiuser; any number of users can edit each article simultaneously without clobbering each other. FogBugz will detect if two users’ changes conflict, and ask the second user to decide how to resolve the conflict. If two users edit different parts of a document, their changes will not conflict and will both be saved.
FogBugz automatically saves drafts in the background as you are editing, in case you close your web browser or it crashes before you can save. When editing the article again, you will be given a chance to recover your changes, even if you never clicked Save.
Each wiki has its own set of permissions. You can make some wikis open to the public, while others are more restricted. Wikis can have their own set of granular permissions. You can choose whether Anonymous and Community users can see and edit the wiki, and you can enable finer controls by assigning the wiki to a group.
Wiki Article Information
NOTE: FogBugz For Your Server customers, make sure the three Wiki Article Info plugins are enabled.
When viewing or editing a wiki article, there is an Info link next to Edit at the top-right. The wiki article info page contains article details, history and a list of all links to and from the article.
The wiki history browser (“recent changes”) shows a list of each change made to the article over time, who made it and how much of the content was changed. For each version, you can click a link to see a graphical display showing what changed relative to the previous version. You can compare any two versions by clicking Next and Previous for each side of the comparison until you see the two versions you want. From the article editor, you can go back to any old version by clicking the left arrow next to the date and time in the top-right, then click Restore Old Version in the top-left.
Restoring the Previous Version
If somebody has made a change that you do not like, just restore the version before they made the change and save it as the current version. This has the effect of undoing their change in two clicks. In practice, this means that it is easier to clean up vandalism than to vandalize in the first place, and it has the effect of keeping the quality of a wiki article very high even when you allow anyone in the world to edit it.
Managing Links with the Article
The info page also shows you what links to the article and what outbound links the article contains. You can copy the article to a new one, set it as the root for the containing wiki or delete the article. You can only delete a wiki article when no other articles link to it (making it an “orphan”).
Users can subscribe to a wiki article to receive a notification when it changes. This is useful to track projects or interesting documents, and it also makes it difficult for a vandal to deface a page without anyone noticing. Vandals eventually give up when they realize that they are not getting anywhere.
Searching wiki articles
FogBugz search includes wiki articles. To search only wiki articles, add
type:wiki to the search terms. To quickly search just the current wiki, use the search box on the article page (if included in the current template).
Tags make it easy to find what you are looking for in FogBugz. Add tags to wiki articles in the tags field at the bottom of the editor. Find your tagged articles later by searching for