Skip to content

Make a glossary change

Dᴼᴷᵀᴼᴿ D. ᵂᵁᴺᴰᴵᴮᴬR edited this page Mar 11, 2017 · 9 revisions

Changes to the repository should be done in relation to the relevant project phases. For the time being, this means mostly phase I, but it may overlap into phase II.

Phase I: migrating from Google Drive

A main goal of phase I is to migrate the work originally done in Google Drive to this repository so that we completely eliminate Google Drive from our workflow. Anyone with a GitHub account can help with Phase I objectives.

This requires doing 3 things:

  1. Create repository Issues for each of the existing terms in the Glossary terms register.
  2. Migrate any pre-existing Google Doc drafts if they actually have any definition content. (Blank files should be deleted from Drive and Drive draft links removed from terms register.)
  3. Build up the repository's glossary index, which, combined with using repository issues, will replace need for the terms register in Google Drive.

The systematic process for to complete phase I:

When that's completed we eliminate Google Drive from our glossary collaboration workflow.

Phase II (and IV): developing glossary definitions

If you helped with Migrating initial drafts in phase I, then you may already feel up to speed with using your GitHub client and working with the repository. But we'll go over the mechanics again, this time without context to Google Drive, which is no longer relevant to us.

Document editing

(forthcoming)

Push commits (Editors level and up)

(forthcoming)

Pull requests (Writers only)

(forthcoming)

Clone this wiki locally