On 8/04/2019 01:07, Peter Dimov wrote:
Bjorn Reese wrote:
What about my questions about a tutorial and design rationale? Those are genuine questions. I am trying to understand if their absence is deliberate or due to lack of time.
The absence of a tutorial and a design rationale are not deliberate, in the sense that I don't believe that the documentation is better without them. Lack of time is more correct.
Absence of a tutorial is fine (I'm sure most people know how variants are supposed to work in general, especially as you're using mostly-compatible interface and behaviour as std::variant), but more motivation and/or design rationale would be nice. Perhaps in lieu of a more focused design rationale section (given time constraints), you could just include a link to http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2016/p0308r0.html (as recently posted by Michael)? I assume that your initial arguments there still apply to this implementation, and it seems like useful background information and/or motivation. (Although it then goes on to talk about unrelated things, and obviously at least some of your thinking has changed over time.) And probably most users (like me) would be unaware of the paper otherwise.