Skip to content

Fix numpydoc in pm.Data, pm.MutableData, pm.ConstantData #5485

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

Merged
merged 16 commits into from
Feb 18, 2022

Conversation

jmloyola
Copy link
Contributor

Addresses #5459.

This PR:

  • Add space between colon in parameters
  • Fix link to Model.set_data function in documentation
  • Fix docstring parameters type
  • Fix link to example notebook
  • Move information to extended description
  • Add punctuation to parameter description
  • Move parameter description to respect parameters order
  • Add double ticks for code references in docstrings
  • Link function in pymc
  • Add default behaviour of optional parameters
  • Add reference to pm.Data in pm.ConstantData and pm.MutableData

The value parameter still references pandas objects (pd.Series, pd.Dataframe).
How should we handle them?

On the other hand, I think the reference notebook remains to be translated to the new version. I don't know if we should leave a comment to remember to change it once it is updated or not.

#DataUmbrellaPyMCSprint

@codecov
Copy link

codecov bot commented Feb 18, 2022

Codecov Report

Merging #5485 (e96232e) into main (af14bea) will not change coverage.
The diff coverage is n/a.

Impacted file tree graph

@@           Coverage Diff           @@
##             main    #5485   +/-   ##
=======================================
  Coverage   81.44%   81.44%           
=======================================
  Files          81       81           
  Lines       14204    14204           
=======================================
  Hits        11569    11569           
  Misses       2635     2635           
Impacted Files Coverage Δ
pymc/data.py 80.67% <ø> (ø)

pymc/data.py Outdated
:func:`pymc.Model.set_data`.

For more information, take a look at this example notebook
https://docs.pymc.io/projects/examples/en/latest/pymc3_howto/data_container.html
Copy link
Member

Choose a reason for hiding this comment

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

We should not use html links to refer to pymc (or other python libraries commonly used like arviz, aesara, numpy...). This should be done with intersphinx:

:ref:`nb:data_container`

Which will show the title of the notebook as link text, so it's probably best to update the text something like "read the notebook"

@OriolAbril OriolAbril merged commit e165cb1 into pymc-devs:main Feb 18, 2022
@jmloyola jmloyola deleted the fix-numpydoc-data branch February 19, 2022 01:14
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