1 / 11

Documentation Planning

Documentation Planning. Seeing the Big Picture. Planning Phases User Analysis Task List Document Design Project Plan. Writing Phases “Alpha” Draft Reviews and Tests Users Content Experts (SMEs) Revisions Final Draft Field Evaluation. The Documentation Cycle.

gartner
Download Presentation

Documentation Planning

An Image/Link below is provided (as is) to download presentation Download Policy: Content on the Website is provided to you AS IS for your information and personal use and may not be sold / licensed / shared on other websites without getting consent from its author. Content is provided to you AS IS for your information and personal use only. Download presentation by click this link. While downloading, if for some reason you are not able to download a presentation, the publisher may have deleted the file from their server. During download, if you can't get a presentation, the file might be deleted by the publisher.

E N D

Presentation Transcript

  1. Documentation Planning Seeing the Big Picture

  2. Planning Phases User Analysis Task List Document Design Project Plan Writing Phases “Alpha” Draft Reviews and Tests Users Content Experts (SMEs) Revisions Final Draft Field Evaluation The Documentation Cycle

  3. Working in “Drop-Dead” Mode • Write and maintain a clear plan • Keep solid, understandable records of every phases (activities and times) • Create file names and structures that make sense (p. 135) • Use your records to plan future projects

  4. Persuasion (management): Logic of your design Willingness to cooperate Planning ability Economic soundness Solid capabilities Dependability & resourcefulness Management (peers & employees): Scheduling tasks Tracking expenses Tracking documents and files Recording meetings Monitoring progress Persuading and Managing: The Documentation Plan

  5. The Parts of a Plan: Summary • Executive Summary: Bottom line in a page or less • Target users • Major documents • Primary objectives • Schedule • Cost

  6. The Parts of a Plan: Users • User Analysis • Brief summary of salient characteristics • Explanation of how characteristics affect documentation • Details reserved for appendices

  7. The Parts of a Plan: Doc Elements • Documentation Types & Outlines: For each document (and sometimes each chapter), provide: • Title • Type (tutorial, procedural, reference, combo) • Media • Specific Goals (linked to users) (p. 159) • Outline (2-3 levels) • Estimated length

  8. The Parts of a Plan: Layout • Document Layout • Rationale • Specifications • Size & binding • Styles, columns, fonts, cuing, etc. • Writing style guide (new companies) • Samples • In text or in appendix

  9. The Parts of a Plan: Schedule • Project Schedule • Major tasks • Drafts & Revisions • Tests & Reviews • Meetings • Milestones • Record-keeping

  10. The Parts of a Plan: Resources • Required Resources • Personnel – writers, editors, testers, SMEs • Hardware – computer & networking capabilities • Software – word processing/desktop publishing, online help, graphics, etc.

  11. The Parts of a Plan: Time • Time & Page Estimates • Total number of pages/topics • Hours per page/topic • Total time • Total cost

More Related