Skip to content

Added more reference docs#338

Open
onel wants to merge 13 commits into
jonashaag:masterfrom
onel:refence-docs
Open

Added more reference docs#338
onel wants to merge 13 commits into
jonashaag:masterfrom
onel:refence-docs

Conversation

@onel
Copy link
Copy Markdown

@onel onel commented Jul 28, 2025

This is a first round of adding minimal reference docs.
Working on a more comprehensive addition right now.

Issue: #337

Comment thread setup.py Outdated
Comment thread klaus/ctagsutils.py Outdated
Comment thread klaus/contrib/app_args.py Outdated
Comment thread klaus/contrib/app_args.py Outdated
Comment thread klaus/contrib/app_args.py Outdated
Comment thread klaus/contrib/wsgi.py Outdated
Comment thread klaus/contrib/wsgi_autoreload.py Outdated
Comment thread klaus/contrib/wsgi_autoreload.py Outdated
Comment thread klaus/contrib/wsgi_autoreload.py Outdated
Comment thread klaus/ctagsutils.py Outdated
Comment thread tools/dumbtest.py Outdated
@jonashaag
Copy link
Copy Markdown
Owner

@onel thanks for taking a stab at this! Good comments should focus on the "why", not the "what" or the "how". The latter are already described by the code, and if you duplicate that information as comments, it gets out of sync with the implementation really quickly.

@onel
Copy link
Copy Markdown
Author

onel commented Jul 29, 2025

@onel thanks for taking a stab at this! Good comments should focus on the "why", not the "what" or the "how". The latter are already described by the code, and if you duplicate that information as comments, it gets out of sync with the implementation really quickly.

Those are good points. Going through your comments and will update the PR soon

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants