Slight documentation / configuration difficulty with license

[fixermark]

In the sandstorm-pkgdef.capnp file, the license field has this form by default:

license = (none = void).

This field is documented here. The documentation lacks examples of how to properly fill out this field, which makes it a little tricky to understand:

• Unclear from documentation why void is valid here, since it's unreferenced in the documentation.
• No explanation of the overall structure of the two-element value. It appears that the first value is the general category (openSource, none, proprietary), with the second value being more detail (so license = (openSource = mit) is valid; based on the description, it appears for proprietary licenses one would want to do license = (proprietary = "The full text of the license because the user will need to see it to accept it") ).
• If publicDomain is chosen, no guidance on what the rest of the field should be. I infer from context it appears to be license = (publicDomain = void) but am unsure.
• No explanation of where notices should go and they aren't referenced in the boilerplate sandstorm-pkgdef.capnp file.

Overall, docs are 90% of the way there, but examples of each of the above cases would really help.

[ocdtrekkie]

This is unfortunately a file generated by Sandstorm itself, which makes it much more annoying to change. But I 100% agree we should clarify it better, I almost always go visit other packages I have released in order to find the right values for this file. Ideally the pkgdef itself should give you reasonable information on how to use it. But we probably should put some examples in the documentation at minimum.

[ocdtrekkie]

I have honestly never read the part of this saying license text is presented to the user, or the reference to notices. I am very curious if any of this actually happens in code because I don't think any apps have ever used it!