Split 'communicate with javascript' page into multiple pages

[feihong]

https://melange.re/unstable/communicate-with-javascript.html has gotten very long. It can give a first-time reader the mistaken impression that you need to read a novella in order to understand JavaScript FFI. Let's move it into its own sidebar section (on the same level as Learn, Reference, Try, etc) and split it into multiple pages:

1. Overview: this would be a new page that summarizes what will be covered in this section. Another idea is that it could be a Getting started page that includes a small example which gives you a taste of how FFI works.
2. Language concepts
3. Data types and runtime representation
4. List of attributes and extension nodes
5. Bind to JavaScript objects
6. Bind to JavaScript functions or values
7. Generate getters, setters, and constructors
8. Bindings cookbook

There are a number of smaller sections that are sprinkled around the current page and I haven't quite figured out where they should go yet. They could go in their own pages, but I'm not sure it makes sense.

• Non-shared data types
• Generate raw JavaScript
• Debugger
• Detect global values
• Inlining constant values
• Use Melange code from JavaScript

[davesnx]

IMO:

• Non-shared data types should be a separate section under 3), but I would improve the content a bit.
• The rest should be under a better category name than List of attributes and extension nodes, but inside.

I also wonder if:

• Could Bind to JavaScript functions or values be introduced by values first and then functions?
• Using polyvariants/variants and other techniques explained on 6, could be a separate section like safer/stronger/better interfaces?

[feihong]

OK, how about this:

1. Overview: this would be a new page that summarizes what will be covered in this whole section. Another idea is that it could be a Getting started page that includes a small example which gives you a taste of how FFI works.
2. Language concepts
3. Data types and runtime representation
   • Non-shared data types, but expanded a bit (I notice it lacks some detail)
4. List of attributes and extension nodes Melange attributes and extension nodes
   • All attributes (table)
   • All extension nodes (table)
   • Generate raw JavaScript
   • Debugger
   • Detect global values (feels like this should be renamed though)
   • Inlining constant values
5. Bind to JavaScript objects
6. Bind to JavaScript values and functions
   • Advice for making more type-safe interfaces
7. Generate getters, setters, and constructors
8. Use Melange code from JavaScript (will be a small page but not sure what to put it under)
9. Bindings cookbook