Since there are many questions equivalentthat ask what you commit to “What did Iwhen you commit to?” a Documentation tag, it seems that “committing” isn’t the best description for what’s happening. Instead, I think there should be a proposal post. By default, it could look like this:
If you meet the requirements, you can edit, vote, and comment on the post. There should be the edit, flagfor spam/unnecessary tags (I.E. [arrays] etc.), and dupefor setting the documentation to another tag (i.e. [python-3.x] → [python])
Let’s create documentation for Friendly name! (not editable)
v The community proposal goes here.
/ \ _\ Some things that go here:
/___\ * What’s getting documented?
3 * Why should we document this?
3 * Anything else about the tag
\‾‾‾/
\ /
^
[share] [edit] [flag] [closeshare asedit duplicate]flag
This sounds great! — A user sometime
-1: This is a bad idea. Because reasons reasons. — Another user sometime later
add a comment
These users have upvoted:
User 1 User 2 User 3 |(empty box)| |(empty box)|
Here’s what the flag dialog could look like:
I am flagging to report this proposal as:
too narrow
This content would be better as a topic or an example, not a tag.
too broad
This content covers a language feature that is implemented in very different ways in different languages (like functions or arrays)
a duplicate…
This content is already documented in another tag or topic.
in need of moderator intervention
A problem not listed above that requires action by a moderator. Be specific and detailed!
The first two and the last one apply to the content of the proposal itself, the others apply to what would be documented.
Too broad would apply to such tags as array and function that are better candidates for being documented in each language tag.
Too narrow would apply to topics like swift-dictionary that shouldn’t stand alone.
Duplicate would apply to tags like swift-3 which should redirect to swift.
If you went to the docs for swift-3, a message should show up after you redirect to swift:
You’ve been redirected to the Swift Language documentation because the swift-3 documentation was closed as a duplicate of this one. You can still view the original proposal if you want it to be considered for reopening.