Page History

...

How We Can Help You

The documentation team can help make a project successful by performing the following tasks and others. We require a charge code for all work. We are experts at accessibility for electronic documents and will make sure that all materials we deliver are Section 508-compliant. 

• Develop user documentation such as user guides, admin guides, and quick reference guides for release in Confluence, Word, PDF, and other formats. 
• Using Lucid Chart, Balsamiq, and other tools, design menus and information on web pages.
• Overhaul or update existing user guides for a new release, including release announcements.
• Write scripts for and record explainer videos about software usage.
• Write online help or tutorials built into the user interface of an application.
• Write/review UI text and error messages for an application.
• Integrate user documentation with project code in GitHub.
• Write or edit software lifecycle documents, API guides, architecture guides, and developer documentation.
• Analyze content in Jira, GitHub, or PowerPoint and create other documents based on that content. 
• Create templates for developers to easily create documentation.
• Perform file conversions, typically to Confluence wiki format, and other file operations as required.
• Remediate any document or wiki page for Section 508 compliance.
• Support project management by preparing team process documents.

How to Request Help

Send the following information in an email message to the NCI Leidos-CBIIT Documentation Team.

• Your first and last name
• Your organization (please spell out acronyms)
• Your request (Notice the suggested tasks below.)request 

Determining Level of Effort

The documentation team can work with the Technical Project Manager to develop a level-of-effort estimate for documentation support. To start this process, provide as much of the following information as possible in an email to the NCI Leidos-CBIIT Technical Documentation Team:

• JIRA issues explaining new features
• URL to for the Development and/or QA servers
• Functional requirements document, if available
• Any other supporting documentation that describes how the features will be implemented
• Development schedule
• Budget available for technical documentation

Upon request, the documentation team can create a detailed documentation plan to estimate the time required to complete the work, confirm the scope of the project, and agree on deliverables. To improve the plan's accuracy, send as much of the information above as possible to the technical writer as soon as possible.

Wiki Management Tasks

The documentation team can help make a project successful by performing the following tasks and others.

• Remediating wiki pages for Section 508-compliance
• Wiki restructuring (creating standard headings on home page, grouping items such as status reports together, and so on)

(If you want to create or update an LDAP group and/or wiki space, contact NCIAppSupport@nih.gov.) 

Technical Documentation Support Tasks

The documentation team can help make a project successful by performing the following tasks and others.

• Updating existing user documentation for new release
• Writing user documentation for initial release
• Writing or editing software lifecycle documents, API guides, and developer documentation
• Perform file conversions, typically to Confluence wiki format, and other file operations as required (could include work in video formats)
• Remediating Microsoft Office documents for Section 508-compliance
• Supporting project management by preparing team process documents

Website Design Tasks

The documentation team is adept at organizing complex information for clear presentation in a website. Using Lucid Chart, Balsamiq, and other tools, we can design menus and information on web pages.

Benefits of Involving the Documentation Team

...

• Documentation is clear and accurate, supporting ease of task completion and expanded and optimal use of applications.
• Documentation meets accessibility standards including Section 508 compliance.
• The NCI Wiki Documentation is organized to make information within it is easy to find.
• Wiki users are able to readily create new wikis and expand existing content, including new topics and new formats.formats.
• Technical staff can spend more time using their unique talents instead of creating or updating user documentation. 

Documentation Feature Catalog

The Documentation Feature Catalog demonstrates selected features available on the NCI Wiki. Examples . Ask us for help incorporating them into your documents. For exploratory purposes, this catalog also includes examples of these features implemented using a site generator are also included for exploratory purposes.