User Tools

  • Logged in as: anonymous (anonymous)
  • Log Out

Site Tools


mantisbt:7075

This is an old revision of the document!


Introduction

This pages outlines the approach to be taken in order for Mantis to support integration with a Wiki.

Why?

Mantis covers very well the area of bugtracker, however, when developers are implementing features that require some sort of upfront brain storming, documentation, and design, the notes approach may become a bit overwhelming. I find that notes are very good for people to provide their thoughts. However, eventually the developer needs to put these thoughts together into one artifact that reflects what exactly will be implemented. This then becomes the basis for documentation, testing, etc.

For agile environments the use of Wiki to manage such documentation is a good option. This can include a description of the feature, some implementation notes, and even some testing notes.

Integration

Single-Signon

Mantis users must not need to login into the Wiki. The wiki must automatically recognise the logged in Mantis user.

Authorisation

What a user can do must depend on their Mantis access level. For example, viewers and reporters may only be able to view the wiki, updaters may be able to edit it, developers/managers/administrators to create pages. The authorisation must also take into consideration the project and whether the issue is private/public.

Integration with Multiple Engines

The integration must be implemented in a way where it is possible to integrate multiple wiki engines with Mantis. The choice may be based on the preference of the company that is using Mantis. However, the Mantis development team will probably only support one integration. At the moment this is the integration with DokuWiki.

How will this affect Mantis?

  • The issue view pages must have a link that points to the Wiki page that corresponds to the current issue. If the page doesn't exist and the user has the appropriate access level, then a page can be created.
  • It should be possible to add a Wiki column that has an icon that links directly to the Wiki page. This is similar to the pen icon that links directly to the update page.
  • string_display_links() should also detect wiki links and hyper link them.
  • Configuration items must be added to allow turning on/off Wiki integration, specify the engine, root of the wiki web, root of the wiki file path, etc.

Wiki Storage

Ideally the Wiki data should be stored in the same database as Mantis. If for some reason the Wiki engine doesn't support all the DBMSes supported by Mantis, then file based storage should be used.

Proposed Wiki Engines

mantisbt/7075.1147271101.txt.gz · Last modified: 2008/10/29 04:31 (external edit)