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

Add and improve docstrings for selected files #368

Merged
merged 15 commits into from
Jul 24, 2024

Conversation

tilen1976
Copy link
Contributor

Docstrings in these files have been edited/corrected or added:

  • external_sources.py
  • core.py
  • dapla_dataset_path_info.py
  • code_list.py

The docstrings should follow https://google.github.io/styleguide/pyguide.html#381-docstrings
The one line summary on top is in imperative-style.

The docstrings has been evaluated partially by chatgpt and some changes are based on this feedback. Like the use of 'side-effects', which seems useful, but I can not find anything about this in Googles style guide.

@tilen1976 tilen1976 requested a review from a team as a code owner July 23, 2024 10:06
Copy link
Member

@mmwinther mmwinther left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looking good, just one little change

src/datadoc/backend/code_list.py Outdated Show resolved Hide resolved
Copy link
Member

@mmwinther mmwinther left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice one 👍

@tilen1976 tilen1976 merged commit 916f433 into master Jul 24, 2024
16 checks passed
@tilen1976 tilen1976 deleted the feat/add-improve-docstrings branch July 24, 2024 12:07
@mmwinther mmwinther added the documentation Improvements or additions to documentation label Jul 25, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants