Skip to content

Task/dss90 improve job docs#151

Merged
sarinasinick merged 6 commits intorelease/9.0from
task/dss90_improve_job_docs
Jul 21, 2021
Merged

Task/dss90 improve job docs#151
sarinasinick merged 6 commits intorelease/9.0from
task/dss90_improve_job_docs

Conversation

@sarinasinick
Copy link
Contributor

Adding some minor changes to improve the docs for the following:

  • added missing docstrings for several bundle methods
  • adding more detailed job definition input information, specifically surrounding possible output types - in combination with https://github.com/dataiku/dss-doc/pull/538 to help clarify job output syntax and available types
  • improved some of the formatting so that the docstrings display as expected on the doc page

@sarinasinick sarinasinick requested a review from FChataigner June 17, 2021 01:02
@sarinasinick
Copy link
Contributor Author

@FChataigner would you mind reviewing some docstring updates to fill out the docs more on some functions that are undocumented?


.. warning::

this stream will monopolize the DSSClient until closed, so the stream must be closed after use or used within a ``with`` statement. For example:
Copy link
Contributor

Choose a reason for hiding this comment

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

I'd drop the "this stream will monopolize the DSSClient until closed" and just say what needs to be done

Copy link
Contributor Author

Choose a reason for hiding this comment

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

👍 updated

@sarinasinick sarinasinick requested a review from FChataigner July 20, 2021 19:41
Copy link
Contributor

@FChataigner FChataigner left a comment

Choose a reason for hiding this comment

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

LGTM

@sarinasinick sarinasinick merged commit d32d73e into release/9.0 Jul 21, 2021
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.

2 participants

Comments