Add information to the documentation regarding the API

[aplteam]

Explain the difference between ...

• a single class
• a bunch of classes
• a stand-alone function
• an API

And mention niladic functions

[aplteam]

Done