Changes between Version 8 and Version 9 of Event/2012/GCI/Document


Ignore:
Timestamp:
11/13/12 07:22:17 (9 years ago)
Author:
Michael Howden
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • Event/2012/GCI/Document

    v8 v9  
    1010* Goals are to make wiki more presentable and give users easier access to information.
    1111== Sahana Eden Tasks ==
    12 
    13 === Update Wiki ===
    14 * Review the flow & navigability of the wiki and send an email to the groups.google.com/group/sahana-eden list with any improvements that you would like to make.
    15 * Recently Sahana Eden implemented new [wiki:DeveloperGuidelines/Templates Template] functionality which made the "deployment_template" folder redundant. Remove or update all historic references to the "deployment_template" folder from the Sahana Eden wiki and [wiki:Book].
    16 * Recently Sahana Eden migrated from using BZR to Git (DeveloperGuidelines/Git). Remove or update all out-of-date references to BZR from the Sahana Eden wiki and [wiki:Book].
    17 
    18 === Test Developers Installation Documentation for Windows ===
    19 Follow the documentation on http://eden.sahanafoundation.org/wiki/InstallationGuidelines to install a developer's instance of Sahana Eden on your Windows OS. Once you have completed send an email to the groups.google.com/group/sahana-eden list stating:
    20 1. Summary of the exact steps you tool
    21 2. Screenshots of Sahana Eden installed on your OS
    22 3. How long it took you?
    23 4. What was the most difficult part?
    24 5. 3 improvements you would like to make - these need to be as specific as possible - does content need to be added? Clarified? Simplified? Is there a need for pictures (of what?)?. Ideally you will edit the documentation on the Wiki to make these improvements yourself.
    25 6. Any other questions you may have about Sahana Eden
    26 
    27 === Test Developers Installation Documentation for Mac ===
    28 Follow the documentation on http://eden.sahanafoundation.org/wiki/InstallationGuidelines to install a developer's instance of Sahana Eden on your Mac OS. Once you have completed send an email to the groups.google.com/group/sahana-eden list stating:
    29 1. Summary of the exact steps you tool
    30 2. Screenshots of Sahana Eden installed on your OS
    31 3. How long it took you?
    32 4. What was the most difficult part?
    33 5. 3 improvements you would like to make - these need to be as specific as possible - does content need to be added? Clarified? Simplified? Is there a need for pictures (of what?)?. Ideally you will edit the documentation on the Wiki to make these improvements yourself.
    34 6. Any other questions you may have about Sahana Eden
    35 
    36 === Test Developers Installation Documentation for Linux ===
    37 Follow the documentation on http://eden.sahanafoundation.org/wiki/InstallationGuidelines to install a developer's instance of Sahana Eden on your Linux OS. Once you have completed send an email to the groups.google.com/group/sahana-eden list stating:
    38 1. Summary of the exact steps you took
    39 2. Screenshots of Sahana Eden installed on your OS
    40 3. How long it took you?
    41 4. What was the most difficult part?
    42 5. 3 improvements you would like to make - these need to be as specific as possible - does content need to be added? Clarified? Simplified? Is there a need for pictures (of what?)?. Ideally you will edit the documentation on the Wiki to make these improvements yourself.
    43 6. Any other questions you may have about Sahana Eden
    44 
    45 === Test Developers Installation Documentation for Amazon EC2 ===
    46 Follow the documentation on http://eden.sahanafoundation.org/wiki/InstallationGuidelines to install a developer's instance of Sahana Eden on Amazon EC2. Once you have completed send an email to the groups.google.com/group/sahana-eden list stating:
    47 1. Summary of the exact steps you took
    48 2. Screenshots of Sahana Eden installed on Amazon EC2
    49 3. How long it took you?
    50 4. What was the most difficult part?
    51 5. 3 improvements you would like to make - these need to be as specific as possible - does content need to be added? Clarified? Simplified? Is there a need for pictures (of what?)?. Ideally you will edit the documentation on the Wiki to make these improvements yourself.
    52 6. Any other questions you may have about Sahana Eden
    53 
    54 === Test Customization Documentation ===
    55 Follow the documentation on http://en.flossmanuals.net/sahana-eden/customisation/ to customize your local instance of Sahana Eden. Once you have completed send an email to the groups.google.com/group/sahana-eden list with:
    56 1. Screen Shots of your customized module
    57 2. How long it took you?
    58 3. What was the most difficult part?
    59 4. 3 improvements you would like to make - these need to be as specific as possible - does content need to be added? Clarified? Simplified? Is there a need for pictures (of what?)?. Ideally you will edit the documentation on the Wiki to make these improvements yourself.
    60 6. Any other questions you may have about Sahana Eden
    61 
    62 === Test Building a New Module Documentation ===
    63 Follow the documentation on http://en.flossmanuals.net/sahana-eden/building-a-new-application/ to customize your local instance of Sahana Eden. Once you have completed send an email to the groups.google.com/group/sahana-eden list with:
    64 1. Screen Shots of your new module
    65 2. How long it took you?
    66 3. What was the most difficult part?
    67 4. 3 improvements you would like to make- these need to be as specific as possible - does content need to be added? Clarified? Simplified? Is there a need for pictures (of what?)?. Ideally you will edit the documentation on the Wiki to make these improvements yourself.
    68 6. Any other questions you may have about Sahana Eden
    69 
    70 === Add Screen Shots to Building a New Module Documentation ===
    71 Follow the documentation on http://en.flossmanuals.net/sahana-eden/building-a-new-application/ to customize your local instance of Sahana Eden. Once you have completed send an email to the groups.google.com/group/sahana-eden list with:
    72 1. Screen Shots of your new module. You will need to take the relevant sections of these screen shots and add them into the Book as examples
    73 2. How long it took you?
    74 3. What was the most difficult part?
    75 4. 3 improvements you would like to make - these need to be as specific as possible - does content need to be added? Clarified? Simplified? Is there a need for pictures (of what?)?. Ideally you will edit the documentation on the Wiki to make these improvements yourself.
    76 6. Any other questions you may have about Sahana Eden
    77 
    78 === Prepare data model relationship entity diagram for each module in Sahana Eden ===
    79 Can use MySQL workbench to reverse-engineer the Eden database into an ERR diagram, then tidy up to show the actually important information for developers (e.g. hide meta-fields, auth references and similar, annotate the foreign keys for links, move objects so they don't overlap too much), for an example see http://pub.nursix.org/eden/err_model.png.
    80 
    81 === Write blueprint to add transliteration to text entry controls ===
    82 Proposed by: [http://lirneasia.net/profiles/nuwan-waidyanatha | Nuwan][[BR]]
    83 '''Specific    : ''' For local language text entry one can use a native language keyboard with native unicode character set or use transliteration to allow entering the native word phonetically. for example with [http://www.google.com/ime/transliteration/ | Google Transliteration Beta] or other plug-in like [ http://www.ucsc.cmb.ac.lk/ltrl/services/feconverter/t1.html | USCS's Real-Time Unicode Converter] [[BR]]
    84 '''Measurable  : ''' Users in Sri Lanka, for example, prefer Sinhala or Tamil languages. Making the option for them to turn on transliteration in Sahana to enter critical information in the local language is an important usability aspect. [[BR]]
    85 '''Attainable  : ''' [[BR]]
    86 Step 1 :: research the available Python/web2py transliteration engines [[BR]]
    87 Step 2 :: trial/experiment with each one to determine the best [[BR]]
    88 Step 3 :: develop a set of recommendations for embedding a generic transliteration engine in Eden [[BR]]
    89 Step 4 :: discuss the recommendations with Sahana community [[BR]]
    90 Step 5 :: document the specifications for developing the agreed on transliteration functionality [[BR]]
    91 '''Relevant    : ''' In community-based disaster management literacy skills including English is poor. Important to develop flexible usable software for inclusiveness [[BR]]
    92 '''Time-bound  : ''' No more than a few days to research the Internet. Another several days to discuss and finalize on the design specifications.
    93 '''Evaluate    : ''' The recommended design would be discussed by the community to evaluate its workability. [[BR]]
    94 '''Reevaluate  : ''' Validate the final specifications document. [[BR]]
    95 
    96 === !Write/Update User Guidelines for a Module ===
    97 Write generic User Guidelines wiki page for a Sahana Eden module based on:
    98 * [http://demo.eden.sahanafoundation.org/ The Sahana Eden Demo Site]
    99 * Existing UserGuidelines
    100 * User Guidelines which have been written for specific deployments of Sahana Eden:
    101  * [wiki:UserGuidelinesEUROSHA]
    102  * [https://docs.google.com/document/d/1gYOqPp2m26uvC5-lDH5OSOM8LZTZOungBTkLLeerM6A/edit RMS User Guide]
     12See: Contribute/Documentation
    10313
    10414== Sahana Vesuvius Tasks ==