From 8279da52193295f94677bb51e826ca4d8fe91106 Mon Sep 17 00:00:00 2001 From: Araq Date: Wed, 5 Feb 2020 13:38:45 +0100 Subject: [PATCH] contributing.rst: Add a special rule for 'outplace'-like features --- doc/contributing.rst | 17 +++++++++++++++-- 1 file changed, 15 insertions(+), 2 deletions(-) diff --git a/doc/contributing.rst b/doc/contributing.rst index 19064b8f9..64732970d 100644 --- a/doc/contributing.rst +++ b/doc/contributing.rst @@ -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.