I was recently evaluating a several options on github for a tool I needed. All options satisfied my basic requirements, so the choice came down to community/recency, and documentation.
I went with the project that was better documented.
Joke was on me, there had been several great feature updates, but without new documentation.
So, please, I implore OS committers, as much as it may be a pain, please require documentation updates when accepting patches!
Comments
I think you're right, and there's a lesson here.
I was recently evaluating a several options on github for a tool I needed. All options satisfied my basic requirements, so the choice came down to community/recency, and documentation.
I went with the project that was better documented.
Joke was on me, there had been several great feature updates, but without new documentation.
So, please, I implore OS committers, as much as it may be a pain, please require documentation updates when accepting patches!