mantisbt:7075
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionLast revisionBoth sides next revision | ||
mantisbt:7075 [2006/05/10 19:29] – Added notifications and related links sections. vboctor | mantisbt:7075 [2008/10/29 04:25] – external edit 127.0.0.1 | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== Introduction ====== | + | This page was moved to [[mantisbt:issue:7075]] |
- | + | ||
- | This pages outlines the approach | + | |
- | + | ||
- | ====== Why? ====== | + | |
- | + | ||
- | Mantis covers very well the area of bugtracker, however, when developers are implementing features that require some sort of upfront brain storming, documentation, | + | |
- | + | ||
- | For agile environments the use of Wiki to manage such documentation is a good option. | + | |
- | + | ||
- | ====== 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. | + | |
- | + | ||
- | ===== Integration with Multiple Engines ===== | + | |
- | + | ||
- | The integration must be implemented in a way where it is possible to integrate multiple wiki engines with Mantis. | + | |
- | + | ||
- | ===== 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. | + | |
- | + | ||
- | * 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, | + | |
- | + | ||
- | * wiki_api.php, | + | |
- | + | ||
- | * wiki_dokuwiki_api.php, | + | |
- | + | ||
- | * Each project should be associated with a wiki page. This page acts as the root for project documentation. | + | |
- | + | ||
- | ===== 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' | + | |
- | * 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. | + | |
- | + | ||
- | ===== Directory Structure ===== | + | |
- | + | ||
- | * Mantis should provide the flexibility to link with a Wiki that is installed in any location on the same server or network. | + | |
- | + | ||
- | * In the case where the Wiki is used only by Mantis, then it would be placed under the Mantis folder (e.g. mantis/ | + | |
- | + | ||
- | * In the case where the Wiki will be used outside the scope of Mantis, then it would be placed in another location. | + | |
- | + | ||
- | ===== Notifications ===== | + | |
- | + | ||
- | Notifications related to Wiki page changes will be handled by the Wiki engine. | + | |
- | + | ||
- | ====== 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:// | + | |
- | + | ||
- | ====== Related Links ====== | + | |
- | + | ||
- | * [[http:// | + |