Addressing comments: re-ordering, adding ToC, removing Scala

* Added table of contents with internal links
* Removed Scala section (may add it to developerDoc.md)
* Simplified some wording
* Readability tweaks
* Moved code sample earlier