[erlang-patches] Documentation patch for ct_hooks

[Jesper Louis Andersen]

On Tue Jun 12 11:09:21 2012, Henrik Nord wrote:

> If there are more people interested in correcting the documentation,
> maybe we can include a branch they all can commit to, set up a branch
> on github, and use the online editor to create pull requests to it,
> and then submit it for review as the code stop draws near?

See, my goal is to make it easy for you (The OTP team) to get patches 
in. I have a hunch that if I commit 100 small documentation patches all 
the time, then we end up in a situation where it will overflow your 
patch queue. I like the idea to have a lieutenant who is responsible 
for a documentation branch in which we could collect all these smaller 
fixes over time. But it really does depend on the amount of 
documentation patches you get as curating such a branch is also work.

My own patch rate is sporadic. I have committed myself to fix errors 
when I see them now. So I will continue to do so. How to push them into 
Erlang/OTP is not really my concern - I just provide patches for them. 
The only thing I am interested in is eventual consistency - that they 
will eventually get in.

> We consider the documentation in much the same way as source code, and
> the documentation is shipped alongside with the application in
> question and is bound by the same version as the applications
> themselves. This makes a more "open" wiki style documentation edit
> approach incompatible as the changes to the documentation also impacts
> the version of the applications.

I see and understand your point.

--
Jesper Louis Andersen
  Erlang Solutions Ltd., Copenhagen, DK