Release `utils/style_doc.py` as a python package
Author: PhilipMay
Pull request: no

Hi,
I like the functionality of your [`utils/style_doc.py`](https://github.com/huggingface/transformers/blob/master/utils/style_doc.py).
Did you ever think about open sourcing it as a python package?

I think other projects might also want to use it.


Comments:
@sgugger 

It's very much linked to the way we write documentation in Transformers so it would need a bit of work to become a standalone package that can be used. I have no time to do it personally, but if someone wants to start building it, I'm happy to review things!

> It's very much linked to the way we write documentation in Transformers so it would need a bit of work to become a standalone package that can be used. I have no time to do it personally, but if someone wants to start building it, I'm happy to review things!

@sgugger ok - cool! So if I would create such a standalone package which can be used by you and others - you would:
- help with review
- switch transformers to that implementation if it works and if I add you as maintainers

Would you do that?

Definitely!

> Definitely!

That is nice! Thanks.

> It's very much linked to the way we write documentation in Transformers

@sgugger The docstring formatter looks very "normal". Do you mean the rst formatter when you say "very much linked"?


I meant there could be plenty of edge cases I never thought of since we write the Transformers documentation a certain way, sorry if I was unclear. Everything in that file is pretty standard otherwise.

Hey @sgugger and @LysandreJik 
We creatated the new repository and added you with "write" role: https://github.com/telekom/style-doc

We can invite more ppl. from HF if you want.
The license is unchanged at "Apache 2.0" with HF still having the copyright with me (us) added.

Credits are given at the readme file.
I hope everything is nice for you.

An review is very welcome. :+1: 

Unfortunately, I also found the first small problem right away: https://github.com/telekom/style-doc/issues/10

More README text and a `CONTRIBUTING.md` will be added later.

Everything is updated now and ready for a first release: https://github.com/telekom/style-doc

This issue has been automatically marked as stale because it has not had recent activity. If you think this still needs to be addressed please comment on this thread.

Please note that issues that do not follow the [contributing guidelines](https://github.com/huggingface/transformers/blob/master/CONTRIBUTING.md) are likely to be ignored.

So since the project is out at pypi now: Do you (HF) want to migrate to that tool?
You have commit rights on the project and can maintain it together with me.
First bug reports (and improvements) are already coming.
@sgugger @LysandreJik 

I can provide a PR if wanted.


This issue has been automatically marked as stale because it has not had recent activity. If you think this still needs to be addressed please comment on this thread.

Please note that issues that do not follow the [contributing guidelines](https://github.com/huggingface/transformers/blob/master/CONTRIBUTING.md) are likely to be ignored.