Page Comparison

...

For the 1.0 release, we will implement online help using DocBook.  DocBook is an open standard of XML markup that allows you to structure documentation into books or articles.  The 0.8 documentation has been converted to XML and we are now using Oxygen to edit the DocBook books.  We are not expecting functional SMEs to modify the XML within Oxygen but will create the content using Word templates provided below.  As some documentation only needs minor modifications, separate documents will be have been created with some content included.

We plan to continue having the Overviews and Guides available from the wiki for the 1.0 release.  Nora will revise the Overview documents created in 0.8 and request SME teams to review.  The Guides will be converted to PDF from the OLE DocBook books and upload uploaded onto the wiki.

Steps for OLE User Guides

...

1. Review your team's spreadsheet tab.
2. If there are additions you feel are missing for this release, please add them
3. Respond to questions posted at the bottom of the list - either in the Additional Notes or via email.
4. To write the documentation:
   
   1. If there are templates noted in the Template Type column, you will find the templates below.
      
      1. Download a copy of the template, follow the directions in red to help fill out the content/; work with other SMEs to complete
         • KFS User Documentation Standards has helpful information about writing technical documentation.
      2. Upload your document to Documentation 1.0 Google Drive Folder
      3. Copy the link and paste it into the spreadsheet's Link to document (in Google Docs) column
      4. Peer review
      5. Put an "x" in the spreadsheet's Done? column. 
   2. If there is only additional information needed, find the link to the document in the links column.
      1. Edit the document/work with other SMEs to complete
         • KFS User Documentation Standards has helpful information about writing technical documentation.
      2. Peer review
      3. Put an "x" in the spreadsheet's Done? column

Templates

TemplateEDoc.docx - for standard OLE e-docs. E-docs are for record keeping (financial documents, editor, etc).

...

NOTE: Many of the screenshots in DocBook have already been updated.  These updates are not reflected in the linked spreadsheet documents but do not worry about capturing the standard shots (noted in #4 below).

As needed:

1. Create output in .png format.
2. To improve legibility of text on the image, capture the largest image possible given the size of the computer screen you are using. Oversized screen images can be resized as needed in Oxygen.
3. For each screen capture of an e-doc, only capture the e-doc.
4. For your reference, this is the standard in which screenshots should be included in our documentation:
   • For e-docs:
     • Under 'Document Layout', insert a single full-length screen shot showing the entire e-doc as it displays when the user first accesses it from the menu. For most e-docs, this means the screen will be shown in create mode rather than edit mode. If the initial display is a search screen, use separate screen shots to show the initial search screen, the results of a search, and the screen display after selecting one of the e-docs listed in the results.
     • Under the subheading for each tab, insert a screen shot of the tab.
     • Under 'Process Overview', if you are documenting e-doc-specific processes and if screen shots will aid in user comprehension, include shots of parts of the screen that change.
   • For maintenance e-docs:
     • Include only a full-length screenshot of the e-doc in edit mode. Do not include separate images of individual tabs.
   • For admin e-docs:
     • Include only a full-length screenshot of the initial display of the e-doc.
   • For interfaces:
     • Include an initial view screen shot.
     • Include screenshots to note steps in the process as necessary.

...