8

What exactly does it mean to commit to a documentation proposal?

The only information given is:
"Once there are 5 committers, the community will be able to document all (some_language_name) topics".

Does it also mean that if you commit to a documentation proposal, it is also your responsibility to add and address relevant topics? How important is it to do or not to do that?
What does SO recommend on who and why a person should commit to a documentation proposal?

3
  • 9
    It is like the old joke about the pig and the chicken and their commitment to a breakfast with ham and eggs. The pig needs to be a lot more committed. This is the chicken's commitment. Nothing is going to happen when you are no longer interested in the project. Commented Sep 6, 2016 at 7:48
  • 2
    It is a very minor bar, but it is a bar nevertheless. You have to find 4 other people who agree that Documentation needs to be created for that tag.
    – Cody Gray Mod
    Commented Sep 6, 2016 at 7:57
  • Honestly, the commitment is less binding than Documentation is functional. Commented May 30, 2017 at 18:25

2 Answers 2

3

This, among many reasons is why we updated our Tag Proposal page in a recent redesign.

Here's a screenshot of what the page now looks like, for one of the proposed tags on Docs -

enter image description here

Among other design and copy updates, we changed 'committing' to 'backing' thus better implying our original intent.

Given we enforce backers to only be those that have -

  • a minimum of 150 rep points AND
  • atleast 1 positively scored answer in the said tag

... we believe we will have an invested group backing the creation of the Doc tag. While we encourage these backers to then subsequently create and/or propose topics and engage in the tag, that's not a requirement.

Also as a backer, you will be automatically signed up to receive notifications on updates to the tag - IRs, Proposed Changes, Discussion threads, Topic Requests. You can however easily adjust your preferences for these notifications - more info on that here.

0
3

I have committed to a lot of documentation proposals, and my Stack Exchange inbox (stackexchange.com/users/[myuserid]?tab=inbox) now receives all:

  • Improvement requests
  • Proposed changes
  • Topic requests

for anything I've committed to document. Opting out of notifications is now available for the following:

  • Improvement requests
  • Proposed changes
  • Topic requests

Not the answer you're looking for? Browse other questions tagged .