Page under construction! Documentation planning and training are still works in process.
Purpose
This space provides information, tools and file storage for development of end user documentation for OLE. Most end users work in various departments within the library system and are not IT specialists. OLE documentation for end users includes user guides and online help, both of which are intended for use as aids in training new users and, thereafter, for reference.
See:
- The User Documentation Planning for more information about each type of documentation OLE plans to provide.
- Module Overviews for the high level requirements that will be featured within the documentation.
- Infrastructure basics to see/learn more about global functionality. The child pages will be linked to from the documentation as needed.
- Documentation Sandbox for the works in progress of the 0.8 documentation.
Contents
Writers Responsibilities
Writers for OLE Documentation are responsible for:
- Obtaining content from functional specs, SMEs, and their own work in the KFS UI. Test Scripts may provide useful also. Nora has added comments that include links to OLETS (the OLE Test Jira ticketing system)
- Writing clear and concise user documentation in the OLE templates provided, according to OLE team standards for content, usage, punctuation, etc.
- Working with SMEs while preparing the original draft and during review cycles in order to improve the quality of content and presentation.
- Storing all drafts as attachments to the Documentation Sandbox
- Handing off drafted sections to ...