Checklist for Approving Internal Knowledge
Process and Procedures
- Article is unique. See Search for Duplicate Knowledge.
- Author has collaborated with knowledge owner and other stakeholders.
- Curated content is properly referenced and has effective context. See Use Curated Content.
- Article is technically accurate, up-to-date, and complete.
- Leads with the service or application name and version number(s) followed by a colon (when applicable)
- Summarizes article contents
- First paragraph is a problem statement or description that provides context
- Sentences are concise and easy to scan, paragraphs are short
- Content is well ordered; topics and subtopics are in a logical sequence
- Refer to "callers", "users", or "they" instead of "you"; use "their" instead of "your"
- Information is technically accurate, up-to-date, and complete
- Application interface terms are referenced just as they appear in the interface
- Topic and subtopic titles are formatted as headings
- Use numbers for steps, bullets for lists
- Application interface terms are in bold
- Link text clearly references the target content (see Create a Link in an Article)
- Non-UMN content is clearly described and easy to use
- Links open in a new window except for in-page jump-to links
- Long articles have a table of contents (TOC) that use in-page jump-to links
- Table(s) have a header row(s)
- HTML is clean
- Images are uploaded (not pasted in)
- Images are accessible
- Images are associated with the step they define
- Images have a TDX-generated 1 pixel border (set in Insert/Modify Image window) to define edges when necessary
- Article is in the appropriate Category
- Owner is set to a Group and selected based on agreement between stakeholders
- Tags include any appropriate technologies or services.
- Next Review Date is set
- Notify Owner on Feedback is checked.