Skip to content

Process for Reviewing Internal Technical Documentation

Brandon Walsh edited this page Jul 21, 2020 · 5 revisions

Service integrations are reviewed whenever someone leaves the team to ensure that they are not responsible for a particular service.

Of our technical documentation, these pages are the most likely to require updating:

But by far the most difficult changes will be those that come from outside the team, as when the GitHub interface changed. The most likely page to need review, then, is the "Making Technical Contributions" wiki - https://github.com/programminghistorian/jekyll/wiki/Making-Technical-Contributions. When reviewing them for necessary updates, these principles should be kept in mind.

  1. Aesthetic changes in the screenshots can probably be ignored. GitHub switched to rounded corners, for example, but that is unlikely going to throw people off on its own.
  2. Any icon changes or more minor changes to the interface should be noted in the running text.
  3. Any substantial changes to the interface probably require a new screenshot. Otherwise, older screenshots can probably still serve.

It's probably a good idea to review these pages once annually. If pressed for time, that particular page could be broken up into two tasks and assigned to different people:

  1. "Editing the site using GitHub through responding to a review"
  2. "developing this site locally" through the end

Technical documentation last reviewed by @walshbr 7/10/2020

New Wiki (in-progress)

Publishing Tasks

Phase 1 Submission

Phase 6 Sustainability Accessibility

Mermaid diagram templates

Communications

Social Media

Bulletin

Events

Call Packages

Administration and Documentation

Members

Internal records

Resource indexes

Lesson Production and Development

Language and Writing

Accessibility

Governance

ProgHist Ltd


Old Wiki

Training

The Ombudsperson Role

Technical Guidance

Editorial Guidance

Social Guidance

Finances

Human Resources

Project Management

Project Structure

Board of Trustees

Clone this wiki locally