Import This¶
In Python there's a poem that you can read by importing the this module.
It has wonderful lessons that the authors of the language learned while designing the python language.
In the same tradition we've done the same thing. Folks who have made significant contributions have also been asked to contribute to the poem.
You can read it via:
Roses are red, violets are blue,
naming your package is really hard to undo.
Haste can make decisions in one fell swoop,
note that LEGO® is a trademark of the LEGO Group.
It really makes sense, we do not need to bluff,
LEGO does not sponsor, authorize or endorse any of this stuff.
Look at all the features and look at all the extensions,
the path towards ruin is paved with good intentions.
Be careful with features as they tend to go sour,
defer responsibility to the end user, this might just give them power.
If you don't know the requirements you don't know if they're met.
If you haven't gotten to where you're going, you aren't there yet.
Infinity is ever present, the unknown may be ignored,
not everything needs to be built, not everything needs to be explored.
Change everything and you'll soon be a jerk,
you may invent a new tool, not a way to work.
Some problems cannot be solved in a single day,
but if you can ignore them, they sometimes go away.
So as we forge ahead, let's remember the creed,
simplicity over complexity, our library's seed.
In the maze of features, let's not lose sight,
of the end goal in mind shining bright.
With each new feature, a temptation to craft,
but elegance is found in what we choose to subtract.
For every line of code, let's ask ourselves twice,
does it add clarity or is it a vice?
There's a lot of power in simplicity,
it keeps the approach strong,
if you understand the solution better than the problem,
you're doing it wrong.