Page MenuHomePhabricator

Find way to check docstrings
Closed, DeclinedPublic1 Estimated Story Points

Description

Find some way to check if function docstrings follow a certain standard, with respect to parameters and such. The conclusion of this should be documented at WMSE wiki.

Event Timeline

There are documentation generators that support different types of documentation syntaxes, but I haven't found one that enforces these, i.e. fails if they're not followed. See: https://wiki.python.org/moin/DocumentationTools.

Sebastian_Berlin-WMSE moved this task from This Week to Done on the User-Sebastian_Berlin-WMSE board.

After a lot of searching, I couldn't find any tool that does this. It may be possible to use one of the document generators and check the output somehow.