update contributing.rst (#16530)

* update docs

* Apply suggestions from code review

* Update doc/contributing.rst
This commit is contained in:
flywind 2021-01-01 11:33:35 -06:00 • committed by GitHub
commit 4a479f4a6e
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23

View file

@ -239,7 +239,7 @@ not guaranteed to stay in sync, so ``runnableExamples`` is usually preferred:
.. code-block:: nim .. code-block:: nim
proc someproc*(): string = proc someproc*(): string =
## Return "something" ## Returns "something"
## ##
## .. code-block:: ## .. code-block::
## echo someproc() # "something" ## echo someproc() # "something"
@ -262,12 +262,12 @@ first appearance of the proc.
echo "hello" echo "hello"
The preferred documentation style is to begin with a capital letter and use The preferred documentation style is to begin with a capital letter and use
the imperative (command) form. That is, between: the third-person singular. That is, between:
.. code-block:: nim .. code-block:: nim
proc hello*(): string = proc hello*(): string =
## Return "hello" ## Returns "hello"
result = "hello" result = "hello"
or or
@ -275,7 +275,7 @@ or
.. code-block:: nim .. code-block:: nim
proc hello*(): string = proc hello*(): string =
## says hello ## say hello
result = "hello" result = "hello"
the first is preferred. the first is preferred.