Details
-
Task
-
Status: Closed
-
Blocker
-
Resolution: Fixed
-
None
-
None
Description
I think it will be a good idea to have online documentation (build instructions,
API references, etc.) for both 2 (2.8.0) and 3 (3.0.0)-series. The reason for this
is that 3.0.0 introduces a number of backwards-incompatible changes and I expect
a sizable chunk of the user base to stick with the 2-series for some time.
My idea on how to do this is to have two sets of "menu links" in the left "menu bar".
One for 2.8.0 and one for 3.0.0 (some links, e.g., "Charter", "Release Info", "Feedback",
etc.) are common for both releases and won't be in the release-specific sections. In
other words, the menu will look like this:
- Readme
- Charter
- Release Info
- Download
--------------
2.8.0:
- Installation
- Build Instructions
- Programming Guide
- Samples
- FAQs
- API Reference
- DOM C++ Binding
- Migration Guide
-----------------
3.0.0:
- Installation
- Build Instructions
- Programming Guide
- Samples
- FAQs
- API Reference
- DOM C++ Binding
- Migration Guide
-----------------
- Feedback
- Bug Reporting
- Mailing Lists
- Source Repository
- Applications
For this to work we will need to "divorce" the website source from the library source
itself (which I believe is a good idea on its own) and put it into a separate SVN project.
The complete website copy will then be built by using the release-independent part
plus the release-specific parts from the latest releases of 2 and 3-series.