mirror of
https://github.com/scrapy/scrapy.git
synced 2025-02-24 11:43:41 +00:00
Minor edits to contributing.rst
Corrected minor grammatical issues and increased clarity of instructions.
This commit is contained in:
parent
b364d27247
commit
ecdd888ff4
@ -48,9 +48,9 @@ guidelines when reporting a new bug.
|
|||||||
`Stack Overflow <https://stackoverflow.com/questions/tagged/scrapy>`__
|
`Stack Overflow <https://stackoverflow.com/questions/tagged/scrapy>`__
|
||||||
(use "scrapy" tag).
|
(use "scrapy" tag).
|
||||||
|
|
||||||
* check the `open issues`_ to see if it has already been reported. If it has,
|
* check the `open issues`_ to see if the issue has already been reported. If it
|
||||||
don't dismiss the report, but check the ticket history and comments. If you
|
has, don't dismiss the report, but check the ticket history and comments. If
|
||||||
have additional useful information, please leave a comment, or consider
|
you have additional useful information, please leave a comment, or consider
|
||||||
:ref:`sending a pull request <writing-patches>` with a fix.
|
:ref:`sending a pull request <writing-patches>` with a fix.
|
||||||
|
|
||||||
* search the `scrapy-users`_ list and `Scrapy subreddit`_ to see if it has
|
* search the `scrapy-users`_ list and `Scrapy subreddit`_ to see if it has
|
||||||
@ -122,7 +122,7 @@ conversation in the `Scrapy subreddit`_ to discuss your idea first.
|
|||||||
Sometimes there is an existing pull request for the problem you'd like to
|
Sometimes there is an existing pull request for the problem you'd like to
|
||||||
solve, which is stalled for some reason. Often the pull request is in a
|
solve, which is stalled for some reason. Often the pull request is in a
|
||||||
right direction, but changes are requested by Scrapy maintainers, and the
|
right direction, but changes are requested by Scrapy maintainers, and the
|
||||||
original pull request author haven't had time to address them.
|
original pull request author hasn't had time to address them.
|
||||||
In this case consider picking up this pull request: open
|
In this case consider picking up this pull request: open
|
||||||
a new pull request with all commits from the original pull request, as well as
|
a new pull request with all commits from the original pull request, as well as
|
||||||
additional changes to address the raised issues. Doing so helps a lot; it is
|
additional changes to address the raised issues. Doing so helps a lot; it is
|
||||||
@ -143,7 +143,7 @@ instead of "Fix for #411". Complete titles make it easy to skim through
|
|||||||
the issue tracker.
|
the issue tracker.
|
||||||
|
|
||||||
Finally, try to keep aesthetic changes (:pep:`8` compliance, unused imports
|
Finally, try to keep aesthetic changes (:pep:`8` compliance, unused imports
|
||||||
removal, etc) in separate commits than functional changes. This will make pull
|
removal, etc) in separate commits from functional changes. This will make pull
|
||||||
requests easier to review and more likely to get merged.
|
requests easier to review and more likely to get merged.
|
||||||
|
|
||||||
Coding style
|
Coding style
|
||||||
@ -170,7 +170,7 @@ Documentation policies
|
|||||||
**do** provide a docstring, but make sure sphinx documentation uses
|
**do** provide a docstring, but make sure sphinx documentation uses
|
||||||
autodoc_ extension to pull the docstring. For example, the
|
autodoc_ extension to pull the docstring. For example, the
|
||||||
:meth:`ItemLoader.add_value` method should be either
|
:meth:`ItemLoader.add_value` method should be either
|
||||||
documented only in the sphinx documentation (not it a docstring), or
|
documented only in the sphinx documentation (not as a docstring), or
|
||||||
it should have a docstring which is pulled to sphinx documentation using
|
it should have a docstring which is pulled to sphinx documentation using
|
||||||
autodoc_ extension.
|
autodoc_ extension.
|
||||||
|
|
||||||
|
Loading…
x
Reference in New Issue
Block a user