Skip to main content
1 of 4
Jed Fox
  • 3k
  • 3
  • 21
  • 30

Revamp the “commit page” for documentation

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

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)|
Jed Fox
  • 3k
  • 3
  • 21
  • 30