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

Update example docs with latest ethpm v3 packages #1683

Merged

Conversation

njgheorghita
Copy link
Contributor

@njgheorghita njgheorghita commented Jul 13, 2020

What was wrong?

examples.rst docs needed an update to reflect the latest ethpm v3 upgrade.

Todo:

Cute Animal Picture

image

@njgheorghita njgheorghita force-pushed the update-ethpm-packages-docs branch 2 times, most recently from 627da86 to 06594c4 Compare July 13, 2020 18:56
Copy link
Member

@wolovim wolovim left a comment

Choose a reason for hiding this comment

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

👍 Just the link nit. Not certain if I've got the 'best practice' right.

docs/ethpm.rst Outdated
@@ -46,6 +46,9 @@ new ``Package`` class for a given package.
>>> OwnedPackage = Package.from_file(owned_manifest_path, w3)
>>> assert isinstance(OwnedPackage, Package)

For a closer look at how to interact with EthPM packages using web3, check out the
`examples page <https://web3py.readthedocs.io/en/stable/examples.html#working-with-contracts-via-ethpm>`__.
Copy link
Member

@wolovim wolovim Jul 13, 2020

Choose a reason for hiding this comment

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

nit: I've been following an existing pattern linking to references instead of full URLs. For example, create an reference (terminology?) above the example with, e.g., .. _ethpm_example:, then here you can link to it like

...check out the :ref:`examples page <ethpm_example>`

This way the link won't break if the name changes or the example moves around.

Copy link
Contributor Author

@njgheorghita njgheorghita Jul 13, 2020

Choose a reason for hiding this comment

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

Nice, yeah that's a good call. I use that style for same-page references, but wasn't sure about cross-page refs (rst is sooo much fun!). But, I tested it locally and it works just as you typed out, thanks!

@njgheorghita njgheorghita merged commit 342166e into ethereum:master Jul 13, 2020
@njgheorghita njgheorghita deleted the update-ethpm-packages-docs branch July 13, 2020 22:38
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