Documentation Wishlist: Difference between revisions

From IHRIS Wiki
No edit summary
No edit summary
 
(4 intermediate revisions by the same user not shown)
Line 33: Line 33:
'''Guided tour of major features at least for Manage/Qualify''' -- a video that is 5 minutes or less and simply shows the highlights of the software.
'''Guided tour of major features at least for Manage/Qualify''' -- a video that is 5 minutes or less and simply shows the highlights of the software.


'''Project goals/mission'''
'''[[Project Goals and Mission]]''' -- mission statement, vision, strategy


'''Project plan and implementation schedule''' (general)
'''[[Project Plans and Schedules]]''' (general implementation plan)


'''On-boarding process''' for (a) new developers and (b) volunteers
'''On-boarding process''' for (a) new developers and (b) volunteers
Line 41: Line 41:
'''Code of conduct''' that facilitates collaboration
'''Code of conduct''' that facilitates collaboration


'''Developer guidelines:''' how to communicate with other developers and submit code; other guidelines for how development is done; any design requirements
'''[[Developer Guidelines]]''' -- how to communicate with other developers and submit code; other guidelines for how development is done; any design requirements


'''Implementation process''' (non-technical): e.g., what are the key steps, who to talk to, etc. This should be included in the'' Implementation Toolkit.''
'''Implementation process''' (non-technical): e.g., what are the key steps, who to talk to, etc. This should be included in the'' Implementation Toolkit.''


'''A process for translating documentation''', e-learning courses and website materials into foreign languages, especially ''French''
'''Documentation process''' -- To include a general writing, categorizing and review process; a process for translating documentation; a process for capturing, reviewing, and sharing documentation that comes from the field; maintenance assignments to ensure that documentation is kept up-to-date.


'''A process for capturing, reviewing and sharing documentation that comes from the field'''; for instance, when can a country-specific document be generalized to benefit the entire community?
[[Category:Pages for Review]][[Category:Project Team Resources]]
 
'''Assign maintenance responsibility''' for different areas of the documentation, spread out over the team, so that documentation is kept up-to-date.
 
'''[http://www.ihris.org/ihris-suite/faq/ FAQ]''' -- Update and make generally more useful.

Latest revision as of 14:44, 12 November 2013

This is a list of documentation needs submitted by members of the iHRIS Global Community. We invite all community members to contribute to this list.

Implementation Toolkit -- need a print version and “living” version that is easier to keep updated; review and identify what’s missing

Administrator's (Implementer's) Guide -- A collection of documentation useful for administrators/implementers that can be output in PDF or Word format. This guide will likely be included in the next iteration of the HRIS Implementation Toolkit. It should also be translated into French and Spanish.

Technical documentation for developers -- Review for redundancy and update as necessary; reorganize into a more structured guide.

Software Release Procedure -- A procedure capturing all steps in the software release process needs to be documented and agreed upon by the iHRIS team. Team members will have assignments they must complete as part of any software release.

Translations -- Document how the translation process works through Launchpad. Add instructions for bulk translation, updating, and enabling different locales.

Installation Instructions -- Requires a clear process, outlined step-by-step.

General iHRIS PowerPoint -- Develop a PowerPoint that can be shared and modified for introducing iHRIS.

General iHIRS Takeaway Sheet -- Revise.

Forms and Fields Map -- Provide a link through which users can request a large printed copy of the map.

Report a Bug -- Document the process.

Security -- Write text that explains how security issues are addressed in iHRIS.

Interoperability -- Write text that explains how interoperability issues are addressed in iHRIS.

Ideas List -- Revise for readability; ranked by priority/difficulty with a team mentor assigned to each who can help volunteers

User's Manuals -- need to be revised; a more user-friendly format is desirable, such as pop-up tips in the software itself. As part of the revision, we would like to identify a tool that can store “nuggets” of help text in a database for easy import into other locations.

Country-Specific Documentation -- Each country team needs to contribute documentation to their wiki page.

Guided tour of major features at least for Manage/Qualify -- a video that is 5 minutes or less and simply shows the highlights of the software.

Project Goals and Mission -- mission statement, vision, strategy

Project Plans and Schedules (general implementation plan)

On-boarding process for (a) new developers and (b) volunteers

Code of conduct that facilitates collaboration

Developer Guidelines -- how to communicate with other developers and submit code; other guidelines for how development is done; any design requirements

Implementation process (non-technical): e.g., what are the key steps, who to talk to, etc. This should be included in the Implementation Toolkit.

Documentation process -- To include a general writing, categorizing and review process; a process for translating documentation; a process for capturing, reviewing, and sharing documentation that comes from the field; maintenance assignments to ensure that documentation is kept up-to-date.