Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

The Zen of Tealish #21

Merged
merged 1 commit into from Nov 23, 2022
Merged

The Zen of Tealish #21

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
1 change: 1 addition & 0 deletions docs/index.rst
View file
Open in desktop
Expand Up @@ -36,6 +36,7 @@ Usage
recipes
questions
cli
zen



Expand Down
26 changes: 26 additions & 0 deletions docs/zen.rst
View file
Open in desktop
@@ -0,0 +1,26 @@
.. _zen:

The Zen of Tealish
==================

Readability is more important than writeability.
Code is for both machines and humans.
Explicit is better than implicit.
Except when it comes to stacks.
Static is better than dynamic.
Verbose is better than terse,
Except when it's not.
Ambiguity must be avoided.
Pragmatism always beats purity.
Surprises are for birthdays.
Boring is good.
Magic is best left to wizards.
Freedom of implementation is important,
But freedom of code style is not.
Optimization of resources is important,
But rarely more important than readability.
The best code is often the code that doesn't exist.
But the bug is also often the code that doesn't exist.
Embrace the uniqueness of the AVM.

Inspired by `PEP-20 - The Zen of Python <https://peps.python.org/pep-0020/>`_.