Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

When a Working Group or Task Force ("group") begins using a GitHub repo to maintain a ToIP deliverable (specification, template, white paper, etc.), our GitHub Issues Management recommends that the group appoint a set of Editors and a set of Maintainers (who are typically a subset of the Editors) to maintain the repo. This page documents the recommended process the Editors and Maintainers should follow to manage the repo, merge PRs, and publish versions of the deliverable.

...

Prefix with the Working Group acronym, we omit the Task Forces acronym as TFs can be short-lived whereas WGs are chartered components of ToIP, so we attribute deliverables to the higher entity.

Suffix with spec/specification (TBD)

  • tswg-keri-specification


Terminology/Glossary:

Terminology repositories are used to capture terms used within a specific working group and are named accordingly to simplify discovery and aggregation.

No suffix to help readability


Templates:

As templates can be reused across WGs there is no formal prefix.
For example, the ISO template was created by the TSWG but could be reused by any WG wishing to pursue ISO standardization.

Suffix with template.

  • iso-template


Guide:

Prefix with the Working Group acronym, we omit the Task Forces acronym as TFs can be short-lived whereas WGs are chartered components of ToIP, so we attribute deliverables to the higher entity.

Suffix with guide.

  • tswg-a-guide


Paper:

Prefix with the Working Group acronym, we omit the Task Forces acronym as TFs can be short-lived whereas WGs are chartered components of ToIP, so we attribute deliverables to the higher entity.

Suffix with paper.

  • tswg-a-paper


Bespsoke:

In some cases we've needed bespoke repo names to support community efforts such as the vLEI EGF public review:

...