Re:PEP 563, PEP 649 and the future of pydantic and FastAPI
by qbasic_forever on Thursday April 15, 2021 @07:08PM
(#26827316)
I like that FastAPI has documentation meant to be read from beginning to end. It walks you through not only the how but the why of core design decisions, and even dives into ancillary things like pydantic. This is in sharp contrast to most python packages of modest size where IMHO the bare minimum effort is put into technical docs. Usually you get something using a 10+ year old Sphinx template that hasn't changed for modern devices, and no description of usage is more than a trite paragraph (i.e. the attention span of a developer writing a docstring).
[ Parent
| on HN ]
Re:PEP 563, PEP 649 and the future of pydantic and FastAPI
by KptMarchewa on Friday April 16, 2021 @06:53AM
(#26832255)
Agreed. This is an issue not only in Python. How many Java packages documentation is just generated Javadoc?