DEV Community

Discussion on: Why I started using Python type annotations, and why you should too

Collapse
 
real_ishan profile image
Ishan Sharma

Great post!

I stumbled into numpy style docstrings when I was looking for a good way to comment code and they do make life a lot easier. Combined with an PyCharm (or any other IDE that understands them), they are very helpful.

I didn't know about data classes, looking forward to your post about them.

Collapse
 
florimondmanca profile image
Florimond Manca

Agreed on the Numpy doc style! I actually found out that you could change the documentation style in Pycharm, and now the first thing I do for new projects is switching from RestructuredText to NumPy right away. ;) It’s a simple, exhaustive and good looking style.

Collapse
 
real_ishan profile image
Ishan Sharma

That's something that I do as well. I wish there was a setting to set it as default for new projects. I went through documentation and searched but it isn't there. 😒

Thread Thread
 
florimondmanca profile image
Florimond Manca • Edited

Never thought of looking that up, but in that case, yes — it's a shame the default setting doesn't exist!