Since there are many questions equivalent to “What did I commit to?”, 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:
Let’s create documentation for Friendly Name.
Below, it should say something like this:
Once this proposal gets 5 votes, documentation for Friendly Name will be opened up for documentation.
If you don’t have the requirements to vote, this will also be shown:
To vote, you must have:
- 150 or more reputation on Stack Overflow
- 1 or more positively scored answers on questions tagged tag-name
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]
The box on the tag pages should show a snippet of the description.
So, here’s what I’m proposing for the “commit” page:
Let’s create documentation for Friendly name! (not editable)
v The community proposal goes here.
/ \ Some things that go here:
/___\ * What’s getting documented?
* Why should we document this?
3 * Anything else about the tag
\‾‾‾/
\ /
^
[share] [edit] [flag] [close as duplicate]
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)|