improve readability and extendability

[Jeansen]

• Remove positional parameters
• Use similar wording for similar tasks
• reduce redundant code lines
• uniform return types
• document code lines
• reduce complexity where possible
• remove magic numbers
• better use of global constants