| 6 | | |
| 7 | | === Notes on Bug Reporting === |
| 8 | | For the purposes of bug reporting tasks for GCI, please make sure that: |
| 9 | | * the bug has not already been reported elsewhere (a bug reported generally for Eden or for Red Cross or for Sandy is the same - it should not be reported three times). Please search through all tickets to see if the bug has already been reported. If it has, your submission will be marked duplicate and you will not be given credit for reporting it. |
| 10 | | * bugs get picked up by the automated testing suite and, because of the quick turnaround, are often fixed without a ticket being raised. So you will also need to check the current Sahana Eden CI Server Test Results to ensure that it isn't reported there. |
| 11 | | * understand that a bug is where the system is not performing as designed. We have received many suggestions for how it should be designed - and these are all valuable - but feature request are not bugs. If the system is performing as designed, but not how you'd like it to work, it is not a bug. A bug will generate a ticket or error message from the system. We are creating a new category for usability enhancements (4 will be required) to capture these, because they are valuable, but much easier to find than bugs. |
| | 7 | '''Notes on Bug Reporting''' |
| | 8 | Helping find bugs in Sahana Eden is really valuable work as it makes sure that the software works reliably for the people who need it. However sometimes bugs are reported which aren't really bugs or have already been reported. So please make sure (especially if you are reporting bugs as part of the Google Code In (GCI) Program!): |
| | 9 | * the bug has not already been reported elsewhere (a bug reported generally for different templates or sites such as Eden or Red Cross are the same - it should not be reported three times). Please search through all tickets to see if the bug has already been reported. If it has, your submission will be marked duplicate and you will not be given credit for reporting it. |
| | 10 | * bugs get picked up by the automated testing suite and, because of the quick turnaround, are often fixed without a ticket being raised. So you will also need to check the current [http://82.71.213.53/RESULTS Sahana Eden CI Server Test Results] AND the current version of the code toensure that the bug is still valid. |
| | 11 | * understand that a bug is where the system is not performing as designed. We have received many suggestions for how it should be designed - and these are all valuable - but feature request are not bugs. If the system is performing as designed, but not how you'd like it to work, it is not a bug. A bug will generate a ticket or error message from the system. If you want to suggest an enhancement please see [wiki:Projects/Design#SuggestaUsabilityEnhancement]. |
| 23 | | Explore either the [http://demo.eden.sahanafoundation.org/ The Sahana Eden Demo Site] or a local instance of Sahana Eden as see if you can find any bugs. Report them following http://eden.sahanafoundation.org/wiki/BugReportingGuidelines |
| 24 | | |
| 25 | | === Report 2 Bugs in Sahana Eden for Hurricane Sandy Response === |
| 26 | | Test the http://sandyrelieftest.sahanafoundation.org/ (you will need to register and wait for approval). Review Deployments/Sandy/Occupy for a better understanding of what this site is used for. Report them following http://eden.sahanafoundation.org/wiki/BugReportingGuidelines and add the {{{sandy}}} keyword. |
| 27 | | |
| 28 | | === Report 2 Bugs in Sahana Eden for Red Cross === |
| 29 | | Test your local instance of Sahana Eden with the IFRC (International Federation of Red Cross and Red Crescent Societies) deployment setting & . In models/000_config.py set: |
| 30 | | {{{ |
| 31 | | settings.base.template = "IFRC" |
| 32 | | ... |
| 33 | | # Over-rides to the Template may be done here |
| 34 | | settings.base.prepopulate = ["IFRC_Train"] |
| 35 | | }}} |
| 36 | | Do this before first running Sahana Eden - or delete the contents of your {{{databases/}}}, {{{cache/}}}, and {{{sessions/}}} folders to force Sahana Eden to prepopulate again. There will be an administrator account generated automatically: admin@example.com password: testing. |
| 37 | | Report them following http://eden.sahanafoundation.org/wiki/BugReportingGuidelines and add the keyword {{{IFRC}}}. |
| | 22 | 1. Test your own [wiki: http://eden.sahanafoundation.org/wiki/InstallationGuidelines local instance] or a demo site of Sahana. You can also review the test run on the [wiki:SysAdmin/ContinuousIntegration Continuous Integration Server] by either reviewing the [http://82.71.213.53/RESULTS Test Results] or subscribing the the [https://groups.google.com/group/sahana-eden-ci-server Ci Server Mailing List]. Make sure that you manually repeat any of the errors in the automated tests and inlucde full instructions for repeating the error in your bug report. |
| | 23 | * if you using your own local instance - consider testing the following [wiki:DeveloperGuidelines/Templates Templates]: |
| | 24 | * default |
| | 25 | * IFRC (in {{{/models/000_config.py}}} change [wiki:DeveloperGuidelines/PrePopulate prepopulate] to {{{settings.base.prepopulate = ["IFRC_Train"]}}} |
| | 26 | * DRMP |
| | 27 | * DRPP |
| | 28 | * CRMT |
| | 29 | * Philippines |
| | 30 | * The following demo sites are available |
| | 31 | * http://demo.eden.sahanafoundation.org/eden/ (Template = default) |
| | 32 | * http://demo.lacrmt.sahanafoundation.org/ (Template = CRMT) |
| | 33 | * http://demo.drm.tl/ (Template = DRMP) |
| | 34 | * http://demo.drrprojects.net/ (Template = DRRPP) |
| | 35 | 2. Report them following http://eden.sahanafoundation.org/wiki/BugReportingGuidelines. Add the name of the template you are testing as a keyword |
