Contribute to documentation tutorial that belongs to a book

asked 2020-07-12 11:30:59 -0500

Christos M. gravatar image

Hello everyone,

I would like to contribute to the tutorials included in the documentation. To be precise I would like to improve / simplify the python code for the erosion and dilation tutorial and add for java and python separate explanations. However, at the top of the tutorial there is a note mentioning that the explanation belongs to the book "Learning OpenCV".

Is it possible to contribute to the documentation and change the note to something like "The explanation is a modified / extended version of the book Learning OpenCV by Bradski and Kaehler"? Or are there any claims that prevent me from doing so?

edit retag flag offensive close merge delete

Comments

OpenCV is a storied community in the sense that you are not allowed to discredit council elders on the basis of committe verification.

kpachinger gravatar imagekpachinger ( 2020-07-12 12:41:20 -0500 )edit

Sorry, but does that mean I'm not allowed to provide further explanations? Or that I'm only not allowed to change the note but to extend the tutorial with language specific explanations?

Christos M. gravatar imageChristos M. ( 2020-07-12 18:29:56 -0500 )edit

Yes you can improve the tutorial. Probably the best would be to mark the sections where the explanations come from the book, something like a footnote maybe?

Eduardo gravatar imageEduardo ( 2020-07-13 07:12:47 -0500 )edit

It is hard to determine the sections, since the explanation is already a modified /abstract version and not an exact copy. I will probably try with a PR to add further explanations and improvements with a RFC for this part.

Christos M. gravatar imageChristos M. ( 2020-07-13 13:34:56 -0500 )edit
2

I would not bother much and just try to improve the tutorial to be honest. Some of these tutorials were contributed by students during GSoC (Google Summer of Code). It is perfectly fine to rewrite the whole tutorial if needed and if it is an improvement.

Eduardo gravatar imageEduardo ( 2020-07-13 22:53:08 -0500 )edit