Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 4 Current »

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:

Annotation Windows

 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 conventions.

See Using a table as a function argument

  • No labels