update contributing.rst (#16530)
* update docs * Apply suggestions from code review * Update doc/contributing.rst
This commit is contained in:
parent
eb25d7dd71
commit
4a479f4a6e
1 changed files with 4 additions and 4 deletions
|
|
@ -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.
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue