-
### What is the idea?
As we continue to open up conda with various plugin hooks, we would like to make sure that the code is easily read.
```[tasklist]
- [ ] https://github.com/conda/conda/pull/1262…
-
Hi,
Static type checkers (mypy, pyright/pylance) are becoming increasingly popular in the python world.
For now they don't work with Dash as there are no type annotations included with the librar…
-
## Proposal: Improve Code Documentation
### Description
Hello and good day. I would love to propose adding comprehensive code documentation, which impacts readability and maintainability to the co…
-
### Current problem
I have some docstrings to explain what certain bits of code does something like
```python
"""
Endpoints for populating the UI with data. These need to consist of some joins…
-
##### Description
I am passing `--global-property=apiDocs=true,modelDocs=true` to the `typescript-fetch` generator, and I would expect it to remove docs from the generated models and api functions,…
-
I am a bit confused about all the different documentation styles. Beside "google" and "epydoc", etc there is also PEP257.
I wonder if you can recommend a doc-style linter and if it matters which on…
buhtz updated
2 months ago
-
The docstrings for the PAML run methods seem a little confusing/out-of-date about the return values.
https://github.com/biopython/biopython/blob/biopython-172/Bio/Phylo/PAML/_paml.py#L88
*"Return …
-
## Request
Add docstrings that can help inform the user and ease the learning curve.
## Motivation
I am a user of Panel and sometimes HoloViews. I have a very hard time understanding HoloView…
-
At the moment, the documentation in the README file is created manually in parallel to inline documentation (Python docstrings). This will be avoided by generating the documentation from the inline do…
rzbrk updated
2 years ago
-
In #73 @lvh noticed that #77 removed a bunch of docstrings, in favor of separate .rst files. Are we cool with this? I agree with @lvh that docstrings are awfully handy. (I hadn't realized that removin…