Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Better documentation needed: Expand the docstring documentation. #315

Open
klinger opened this issue Dec 8, 2015 · 4 comments
Open

Better documentation needed: Expand the docstring documentation. #315

klinger opened this issue Dec 8, 2015 · 4 comments

Comments

@klinger
Copy link
Contributor

klinger commented Dec 8, 2015

We have good documentation - but we also have lots of classes and functions without any docstring documentation. About docstring documentation see https://www.python.org/dev/peps/pep-0257/

Why this is important:

  • We want to refactor a lot of code, especially concerning the new user interface.. Without documentation its very difficult to refactor.
  • We are an international team working on the whole codebase in a semi-chaotic way - everyone may work on any part of the code. Documentation helps a lot.
  • Its easier to easer to reuse code if you exactly know what it does.
@leodabbler
Copy link
Contributor

Strictly agree, would help me as well.

@ghost
Copy link

ghost commented Feb 12, 2016

I started to write and extend docstrings in a branch docstring as I am learning django and using vp as a reference. Tell me if they are of help or what to change.

@klinger
Copy link
Contributor Author

klinger commented Feb 13, 2016

Hello @dixmartin
i didnt see a commit in your github doctring branch yet. https://github.com/dixmartin/volunteer_planner/commits/docstrings - but PEP8 docstring documentation is always useful. Please continue!

If you have documentation just commit and make a pull request - as long as you dont change functionality its safe to merge to develop branch: release early, release often! Would help me to understand the code too!

@ghost
Copy link

ghost commented Feb 15, 2016

Allright I made a pull request #353.

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

No branches or pull requests

3 participants