fixing documents

[c-chaitanya]

No description provided.

[nicolaskruchten]

Thanks very much for this big sweep! I'll merge this and it should hit our site in 10-20 minutes :)

[nicolaskruchten]

@c-chaitanya how hard would it be to run this process on the function docstrings? It would be nice to batch-fix issues like #3074 if possible rather than doing them one at a time ;)

[jmonticolo]

not only docstrings, but functions arguments too like this one : num_of_defualt_colors.

[nicolaskruchten]

🙈 yikes, that's awkward :) well, that's been in our public API for so long I'm not sure it would be all that helpful to change it now but maybe we can do it in the v5 bump

[c-chaitanya]

Hi @nicolaskruchten
I have also tried this approach for the docstring part of python scripts. The issue I faced was that there were several entries(over 5000) in my output file, and all of them were from the tox folder. I wasn't sure if files in tox needed to be corrected. So I just left them. (Maybe my file iteration logic might be wrong have to check)

But to answer the question, yes this script should in theory work on any text corpus. I'll try to fix and run the code over this weekend.