- User searches JIRA to see if the issue already exists (Sakai Jira Search)
- Search strategies include searching for a particular component, sorting by update date, and exporting as an MS Excel file (in Views)
- User searches the sakai mailing lists archives (nabble sakai lists archives)
- Searching nabble sakai-dev archives may help if you get too many results
- If user is not sure if the problem is a bug, they send a note to the sakai-dev mailing list first to ask
- User creates an issue in Jira of the appropriate #Issue Type
- The component should be set if it is known (leave blank if not sure)
- The Assignee should be set as Unassigned (ideally) or left as -Automatic- (do NOT assign to a developer directly)
- The Affects Version should be set to the released version of the instance of Sakai being used.
- The Fix Version should be left set to the default of Unknown. The project teams will set the Fix Version once they have had time to review the issue and estimate when they believe they will be able to address it.
- As much of the following information should be included as possible (to avoid the issue being closed as incomplete)
- Sakai version
- (bugs) Steps to reproduce (detailed and step by step)
- Environment details (DB type and version, tomcat version, OS type and version, Browser and version, etc.)
- (bugs) URL to the page where the error occurs
- (bugs) Stacktrace (traceback) if available
- (bugs) relevant portions of the server logs (do not attach your entire logs, we do not have time to read through 1000s of lines of logs and figure out where the relevant parts are)
- (bugs) Screenshots showing the error
- (feature) Use cases and detailed requirements
- The desired resolution
Definition for Sakai
An error in design or implementation which directly impedes a user from achieving their expected result.
A new capability being added to Sakai.
A desired capability, for inclusion in a future release of Sakai; ideas that come with resources interested in implementing them are more likely to be developed than those offered with the hope that someone else will step forward to do the work.
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="246a5b86f56ba9af-22cf6de3-46e14ef2-b093a21c-754724c4280142332f0da2a5"><ac:plain-text-body><![CDATA[
A community-contributed patch to a particular version of Sakai. The origin of such issues may lie in Bugs or Feature Requests which Sakai has not yet evaluated for implementation. Under such circumstances a linked issue is generally created by cloning the original issue in order to track Sakai's work on the issue. [Use at your own risk!]
An experimental branch of code, which may or may not be merged back into the main code after the experiment completes; identified in SVN by a branch named with the Jira Key.