Here’s my draft of tag-organization from a PM discussion with the devs. I don’t think it’s right anymore, but it might spark some ideas,
Tags
These tags are grouped as teletype only tags. If the teletype tag isn’t included, these tags won’t be available. Tags can be edited once they’re created, so elements of the tags will change over time. Tags are meant to organize content in a matrix rather than a hierarchy. Posts will most likely have more than one tag.
/ denotes tags that commonly go together, but are separate tags. [things in brackets] mean that things inside the brackets are variable depending on the information being tagged. [things|separated|by|bars] mean that the tag should be one of the words inside the brackets, so [released|inprogress|onhold] means that the tag should be released, inprogress or onhold.
-
teletype / [op|pre] / [command]-[github-issue]-[released|inprogress|onhold]
- discussion threads that mention commands. The tag can be as simple as
op or contain a tag for the command described in the post, r to tag an op command called R. Once the command is added to Github issues for implementation, the tag can be edited to include new information.
-
teletype / tt-[description]-[active|archived]
- general tag to collect discussion of a broader topic that hasn’t yet resulted in a command or language suggestion. While the prefix
tt- is redundant with the teletype tag, the prefix gives the tag some extra heft as an ‘official’ discussion topic.
-
teletype / monome-approved
- tag that denotes a feature has been vetted and approved for inclusion in the monome TT firmware implementation of the TT language. Does not mean the feature is scheduled for development, or even added to Github issues. This tag is a good place to start if you’re a developer looking for a feature to add.
-
teletype / alt
- this tag means that the discussed features, while interesting, won’t be included in the monome TT firmware and have yet to find a willing implementor as an alternative firmware.
-
teletype / alt-[alternative firmware name] /
- tag to denote development discussions for alternative versions of the TT firmware.
-
teletype / release-[candidate|beta|production]-[github release tag, PR or shorthand name]
- optional tag to collect discussions that relate to a monome TT firmware release.
-
teletype / bug-[github issue id]
- tag to flag something as a bug. When the bug becomes a github issue, the issue ID can be added for clarity.
Organizing Threads
When multiple ideas emerge from a single thread, the moderators will make their best effort to split ideas into their own threads. While it’s difficult to predict what a discussion will produce, when possible community members are encouraged to keep one topic per thread.
When posts are moved into new threads, or when a thread gains enough traction, moderators may add an index ‘top post’ and change the title to clarify status of the discussion. Thread titles will closely mirror tagging structure,
- New command threads will be formatted,
TT-[op|pre]-[command]-monome-approved-[candidate|beta|production] [additional description]
- Release status threads will be formatted
TT-[monome|alt]-release-[release tag]-[released|inprogress|onhold] [additional description]
Top posts in reorganized threads will link to Github issues, pull requests or releases when possible. Though top post index content will vary according to the purpose of the thread, index authors are encouraged to link to related tags and make use of Markdown tables and formatting for clarity. As index post patterns emerge, templates will be added to this Wiki.
A gif about how I feel right now
I like tags. I like tags a lot.