This is an imported issue, original reference WP-221, created on 14 Dec 2014.

Right now, we've got a branch for docs v1.0 and 2.0. Some content when writing docs for 2.0 should also belong to 1.0 so we should cherry-pick it, not forget about it etc. Overall, the branches are quite hard to manage.

A suggestion: have a single set of documentation and somehow mark the docs articles or even their section with a version tag, for example:

--
appliesToVersions: 2.*
--

1.  This is some topic

Some docs to it…

## Subsection [appliesToVersions: >=3.0.0]

This subsection is only valid for the 3.x release..