Skip to content
This repository has been archived by the owner on Dec 7, 2022. It is now read-only.
/ pulp Public archive

Add note to convert ported docstrings #3055

Merged
merged 1 commit into from
Jun 12, 2017

Conversation

asmacdo
Copy link
Contributor

@asmacdo asmacdo commented Jun 12, 2017


PUP-2 TODO(asmacdo)link adopted the use of Google Style Docstrings TODO(asmacdo)link. When developers port code from Pulp 2 to Pulp 3, they should also convert all the docstrings to the new style.
Copy link
Member

Choose a reason for hiding this comment

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

I went to review this, but it looks like it is still a work in progress. We shouldn't commit TODOs to the docs so maybe put a WIP? I can review whenever if you put a comment w/ my nick on it.

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 missed that change in git. The corrected links are pushed.

@asmacdo
Copy link
Contributor Author

asmacdo commented Jun 12, 2017

@bmbouter ready for review


`PUP-2 <https://github.com/pulp/pups/blob/master/pup-0002.md>`_ adopted Google style for :ref:`google-docstrings`. When developers port code from Pulp 2 to Pulp 3, they should also convert all the docstrings to the new style. vim-style regexes can be used to speed up the process. Together, these will convert all of the parameters to Google Style::
Copy link
Contributor

Choose a reason for hiding this comment

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

extra space at the beginning of this line is causing styling issue


`PUP-2 <https://github.com/pulp/pups/blob/master/pup-0002.md>`_ adopted Google style for :ref:`google-docstrings`. When developers port code from Pulp 2 to Pulp 3, they should also convert all the docstrings to the new style. vim-style regexes can be used to speed up the process. Together, these will convert all of the parameters to Google Style::
Copy link
Contributor

Choose a reason for hiding this comment

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

s/developers port/porting/

Copy link
Contributor

Choose a reason for hiding this comment

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

s/they should//

@asmacdo asmacdo merged commit 70fd50b into pulp:3.0-dev Jun 12, 2017
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants