While working on #1915 I've run into some areas where the documentation is lacking. This issue is a list of topics that I think need work. It may change over time.

• public and constant as methods applied to storage variables
• scoping rules
• for loops
• tuples
• contract objects
• memory layout of data types
• pass-by-reference / pass-by-value
• abi format
• arithmetic functions (should be moved from types to builtin functions)