What are the best practices? Do you use Sphinx. If so how does your deployment look like? Is it worth the effort for a small startup to spend time and effort on it?
How do you document your python code?
1–4 of 4 posts
Re: How do you document your python code?
#2It totally depends on what you want to succeed. In our case, for example, we break our python code into microservices so it is more important documenting the APIs rather the code itself. If you are building complicated libraries, yes sphinx is the choice to go. Most important of all is to understand your deployments and your code lifecycle.
Re: How do you document your python code?
#3It totally depends on what you want to succeed. In our case, for example, we break our python code into microservices so it is more important documenting the APIs rather the code itself. If you are building complicated libraries, yes sphinx is the choice to go. Most important of all is to understand your deployments and your code lifecycle.
> we break our python code into microservices so it is more important documenting the APIs rather the code itself.
If you write libraries (and you actually do without microservices), you still need to document the APIs. No difference there.
Re: How do you document your python code?
#4Our python projects have There are hardly any comments on the projects.
So, far we've not faced any issue.