Naming convention for table parameters
We use this naming convention.
-
All lower case.
-
Prefer short single words if possible
-
Words separated by underscore characters _
Preferred | Instead of | Why |
|---|---|---|
key | password | Better to be consistent with the use of key If we can |
organization | Organization | Small case |
space | ConfluenceSpace | Space is shorter and has less redundant words in front of it. |
user | username | This gives the same information and is shorter. |
Using a single consistent naming convention makes it easier for many customers to learn Iguana
So imagine you read a book that was written in a combination of 5 languages. It might make for an intellectually curiosity, but it would greatly reduce the number of people who could understand.
With Iguana we want our platform to be easily accessible expressing the code using a consistent simple ‘language' is important. It's about reducing Bottlenecks for our users to understand how to use Iguana.
Why favour shorter names
This makes for code which is briefer and easier to read. There is more space for:
Why English?
Unfortunately this does mean we have to pick a language - we pick English since we are based in North America and this is the defacto global language and most of our customers pick English.
Lua itself uses English keywords. One has to pick a standard.
See Naming Convention.