[Python-ideas] Reducing language complexity

[anatoly techtonik]

One of the tools to reduce language complexity is "explicitness" or
the direct link to help/tutorial/documentation from the concept. The
problem with most concepts in computer languages that they don't have
distinct markers by which you can recognize one feature or another.
For example, you can't recognize that code is generator based or uses
metaclass magic without searching for yield or some references to
metaclass through the source file.

One of the ways to reduce language complexity for new people who read
you code, is to prepare them for advanced concepts that your code uses
beforehand. For example, with the following section:

using generators as yield

         ^^^ name of this language feature and also help reference
                              ^^^ distinct keywords and feature
markers that you enable
--
anatoly t.