mirrors/Nim
1
0
Fork 0
mirror of https://github.com/nim-lang/Nim.git synced 2026-04-19 05:50:30 +00:00
Code Issues Packages Projects Releases Wiki Activity

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
parent ab525cc48a
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.
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,
battle-tested modules eventually rather than creating modules from scratch.