In working on #122 and #124, I've come to the conclusion that we need versioned documentation for this component. Doing so allows us to refer users to the documentation specific to their major version, but also allows us to simplify examples: v1 code samples show only code compatible with v1, etc.
This patch provides a possible approach, by creating two trees, v1 and v2, each with their version-specific documentation. Documentation for the current/upcoming version is in the root tree.
In working on #122 and #124, I've come to the conclusion that we need versioned documentation for this component. Doing so allows us to refer users to the documentation specific to their major version, but also allows us to simplify examples: v1 code samples show only code compatible with v1, etc.
This patch provides a possible approach, by creating two trees,
v1andv2, each with their version-specific documentation. Documentation for the current/upcoming version is in the root tree.