NodeMaterial documentation

I’d be willing to write documentation for node-based materials in three.js, but need to get a couple questions answered before I feel comfortable doing so.

1. Is StandardNodeMaterial the material that should be documented, and not MeshStandardNodeMateral? I believe that’s true, based on https://github.com/mrdoob/three.js/pull/14572#issuecomment-430067719 and the goal that MeshStandardNodeMaterial will just be a drop-in replacement for MeshStandardMaterial but the docs would be very different if this is wrong.
2. Which syntax (see https://github.com/mrdoob/three.js/pull/17105 and https://github.com/mrdoob/three.js/pull/17265) should be documented?

I’d prefer to document only one recommended material class, and one recommended syntax style, at the beginning — even if multiple will be available. I’m a bit nervous about having many syntax permutations in use so early with this API.

/cc @sunag @bhouston

[sunag]

@DennisSmolek in next release, some goals are:

• [ ] add support to serialization files in NodeEditor https://github.com/mrdoob/three.js/pull/23376
• [ ] create a serialization system to new NodeMaterial https://github.com/mrdoob/three.js/pull/23314
• [ ] publish NodeMaterial docs

There’s a lot of open to finalize beside these, this might take a while to list, but I think any contribution would be of great help.

[sunag]

@DennisSmolek I started developing NodeMaterial docs about a week or two ago. I will post what I developed in the next few days even if unfinished I think it might help . Your suggestion is good, I think it’s worth sharing some goals.