User Tools

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

Site Tools


mantisbt:7075

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
mantisbt:7075 [2006/05/10 10:55]
vboctor
mantisbt:7075 [2008/10/29 04:25] (current)
Line 1: Line 1:
-====== Introduction ====== +This page was moved to [[mantisbt:issue:7075]]
- +
-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 Sign-on ===== +
- +
-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 [[http://​www.DokuWiki.org|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_api.php,​ an API that allows Mantis code-base to deal with the Wiki generically. ​ When calling this API, the calling code must not need to know the wiki engine being used. +
- +
-  * wiki_dokuwiki_api.php,​ there will be one of these per support Wiki engine (replace "​dokuwiki"​ with the engine name). ​ Such drivers will provide the necessary engine specific implementations that are used by wiki_api.php. +
- +
-===== How will this affect the Wiki engine? ===== +
- +
-The wiki engine will be changed as follows: +
-  * Use Mantis authentication. +
-  * Use Mantis authorisation (access control). +
-  * Support for adding a header and footer that integrates the Wiki into Mantis interface and potentially into the customer'​s website. +
-  * Ability to link to a Mantis issue (similar to #123 that is used within Mantis). +
-  * Support for Mantis specific fields, e.g. id, summary, reporter, developer, etc.  Such fields will be replaced at rendering time with actual values supplied by Mantis. +
-  * Mantis Menu +
-  * The issue wiki page must have a link back to the view page of the issue. +
- +
-===== 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. +
- +
-====== Distribution ====== +
- +
-  * Mantis will be distributed with the code necessary to integrate with the Wiki, but not with the code of the actual Wiki. +
- +
-  * Enough documentation will be able to indicate the supported Wikis and whatever work necessary to get the integration working. +
- +
-  * In the future, a default Wiki may be included as part of Mantis distribution. +
- +
-====== Proposed Wiki Engines ====== +
- +
-  * [[http://​www.DokuWiki.org|DokuWiki]]+
mantisbt/7075.1147272955.txt.gz · Last modified: 2008/10/29 04:31 (external edit)