Skip to content

Conversation

@strickvl
Copy link
Contributor

@strickvl strickvl commented Jun 9, 2022

I added docstrings for materializers and metadata_stores.

Pre-requisites

Please ensure you have done the following:

  • I have read the CONTRIBUTING.md document.
  • If my change requires a change to docs, I have updated the documentation accordingly.
  • If I have added an integration, I have updated the integrations table.
  • I have added tests to cover my changes.

Types of changes

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to change)
  • Other (add details above)

@strickvl strickvl added documentation Improvements or additions to documentation internal To filter out internal PRs and issues labels Jun 9, 2022
@strickvl strickvl requested a review from fa9r June 9, 2022 13:33
Copy link
Contributor

@fa9r fa9r left a comment

Choose a reason for hiding this comment

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

Great work, just added several minor questions/suggestions regarding wording below.

# add modules to this list as/when they are completed.
# When we're done we can remove this and just use `SRC_NO_TESTS`.
DOCSTRING_SRC=${1:-"src/zenml/alerter src/zenml/artifact_stores src/zenml/artifacts src/zenml/config src/zenml/io src/zenml/model_deployers src/zenml/cli src/zenml/entrypoints src/zenml/experiment_trackers"}
DOCSTRING_SRC=${1:-"src/zenml/materializers src/zenml/metadata_stores"}
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
DOCSTRING_SRC=${1:-"src/zenml/materializers src/zenml/metadata_stores"}
DOCSTRING_SRC=${1:-"src/zenml/alerter src/zenml/artifact_stores src/zenml/artifacts src/zenml/config src/zenml/io src/zenml/model_deployers src/zenml/cli src/zenml/entrypoints src/zenml/experiment_trackers src/zenml/materializers src/zenml/metadata_stores"}

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I'm not quite sure what happened here?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I think I understand. This docstring.sh is a temporary script that will probably go away once the main docstring PR is merged. I think this can be ignored.

Comment on lines -103 to -105
Returns:
Any object that is to be passed into the relevant artifact in the
step.
Copy link
Contributor

Choose a reason for hiding this comment

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

Why was this removed?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Because it doesn't actually return that...

Args:
executions: List of executions.
pipeline: PipelineView.
Copy link
Contributor

Choose a reason for hiding this comment

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

What is PipelineView?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Changed.

"""Gets all runs for the given pipeline.
Args:
pipeline: PipelineView.
Copy link
Contributor

Choose a reason for hiding this comment

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

What is PipelineView?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Changed.

@strickvl strickvl mentioned this pull request Jun 9, 2022
8 tasks
@strickvl strickvl requested a review from fa9r June 9, 2022 21:16
@strickvl strickvl merged commit f6cc203 into develop Jun 10, 2022
@strickvl strickvl deleted the misc/ENG-955-ENG-956-docstrings branch June 10, 2022 08:49
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 internal To filter out internal PRs and issues

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants