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
parent eb25d7dd71
commit 4a479f4a6e

View File

@@ -239,7 +239,7 @@ not guaranteed to stay in sync, so ``runnableExamples`` is usually preferred:
.. code-block:: nim
proc someproc*(): string =
## Return "something"
## Returns "something"
##
## .. code-block::
## echo someproc() # "something"
@@ -262,12 +262,12 @@ first appearance of the proc.
echo "hello"
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
proc hello*(): string =
## Return "hello"
## Returns "hello"
result = "hello"
or
@@ -275,7 +275,7 @@ or
.. code-block:: nim
proc hello*(): string =
## says hello
## say hello
result = "hello"
the first is preferred.