jyapayne/Nim
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

contributing.rst: Add a special rule for 'outplace'-like features

Browse source
This commit is contained in:
Araq 2020-02-05 13:38:45 +01:00
commit 8279da5219
1 changed files with 15 additions and 2 deletions
Download patch file Download diff file Expand all files Collapse all files

17
doc/contributing.rst
View file

@ -498,8 +498,21 @@ This covers modules like ``os``, ``osproc``, ``strscans``, ``strutils``,
``strformat``, etc. ``strformat``, etc.
New stdlib modules do not start as stdlib modules Syntactic helpers can start as experimental stdlib modules
------------------------------------------------- ----------------------------------------------------------
Reason: Generally speaking as external dependencies they are not exposed
to enough users so that we can see if the shortcuts provide enough benefit
or not. Many programmers avoid external dependencies, even moreso for
"tiny syntactic improvements". However, this is only true for really good
syntactic improvements that have the potential to clean up other parts of
the Nim library substantially. If in doubt, new stdlib modules should start
as external, successful Nimble packages.
Other new stdlib modules do not start as stdlib modules
-------------------------------------------------------
As we strive for higher quality everywhere, it's easier to adopt existing, As we strive for higher quality everywhere, it's easier to adopt existing,
battle-tested modules eventually rather than creating modules from scratch. battle-tested modules eventually rather than creating modules from scratch.