[CS2] Docs updates

[GeoffreyBooth]

I’m trying to close all the open tickets regarding documentation, and make general docs improvements in preparation for 2.0.0-beta2. See live: https://rawgit.com/GeoffreyBooth/coffeescript/docs/docs/v2/index.html

• Rewrote “CoffeeScript 2” section to introduce CS2, explain what’s new and why 2 is important; moved practical info about transpilation into “Usage”
• JS API #3551: Node module API
• Docs: Lexical Scoping and Variable Safety #2360: Remove incorrect reference to Ruby variable scoping
• Docs: if item not in items #3281: Add example if item not in items
• Better documentation of regular operators, including adding from and the JS equivalent for in
• Docs: enhance documentation of existential operators #1631: Much more comprehensive documentation of the existential operator
• [CS2] Destructuring #4478: Fix destructuring’s comment about default values
• Move the chaining function calls documentation out of the changelog into its own section
• Spinoff separate sections for generator and async functions (from section on bound/fat arrow functions)
• [CS2] Remove support for bound instance methods #4530: Removed support for bound instance methods
• [CS2] Remove unnecessary utility helper functions #4526: No more extends keyword for function prototypes
• Named Functions #15, [CS2] Named functions #4531: Named functions
• Add separate sidebar links for the sub-sections of “Unsupported ECMAScript Features” and “Breaking Changes from 1.x”

I closed #2039, about comprehensions, as the docs as written matched it almost word for word. I guess someone forgot to close it after the docs were updated sometime long ago.

[xixixao]

One thing I noticed while trying the new docs, while it's awesome that the examples are editable! the page is quite slow and janky. It might be because of all these editors or for many other reasons. Compare scrolling through the current page vs the new one.

Thanks for all your hard work 👍

[GeoffreyBooth]

Yeah I’m pretty sure it’s because of all the editors. It’s a sacrifice I’m willing to make 😄 though maybe we could make them read-only on mobile sizes. Pull requests welcome 😉

Another thought is to initialize Codemirror only when the user clicks into the code, so that we only initialize the editors we need to.

[GeoffreyBooth]

Any other notes? @lydell or @jashkenas? @connec I updated the classes docs to reflect that bound methods are no longer allowed.

Anyone familiar with the Node API who can verify that I've documented it correctly?

[lydell]

Awesome!