[
https://issues.apache.org/jira/browse/KARAF-1078?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
Andreas Pieber updated KARAF-1078:
----------------------------------
Description:
Jamie, Christian and I (Andreas) had a longer discussion in IRC how we think
it's best to structure the documentation-website relationship. It could be
nailed down to the following points:
# Have a static link from the website to (always) the latest documentation
(e.g. http://karaf.apache.org/manual/latest/users-guide/index.html)
# linking from the main page to a page containing a link to all the specific
docs; e.g. http://karaf.apache.org/manual/latest-2.2.x/users-guide/index.html
http://karaf.apache.org/manual/latest-2.3.x/users-guide/index.html, ...
# never delete the manuals, even if we have
http://karaf.apache.org/manual/latest-9.18.x/users-guide/index.html :-)
# link to the specific documentations from the release pages of each release
was:
Jamie, Christian and I (Andreas) had a longer discussion in IRC how we think
it's best to structure the documentation-website relationship. It could be
nailed down to the following points:
# Have a static link from the website to (always) the latest documentation
(e.g. http://karaf.apache.org/manual/latest/users-guide/index.html)
# linking from the main page to a page containing a link to all the specific
docs; e.g. http://karaf.apache.org/manual/latest-2.2.x/users-guide/index.html
http://karaf.apache.org/manual/latest-2.3.x/users-guide/index.html, ...
# never delete the manuals, even if we have
http://karaf.apache.org/manual/latest-9.18.x/users-guide/index.html :-)
> Restructure linking to documentation
> ------------------------------------
>
> Key: KARAF-1078
> URL: https://issues.apache.org/jira/browse/KARAF-1078
> Project: Karaf
> Issue Type: Improvement
> Components: website
> Reporter: Andreas Pieber
>
> Jamie, Christian and I (Andreas) had a longer discussion in IRC how we think
> it's best to structure the documentation-website relationship. It could be
> nailed down to the following points:
> # Have a static link from the website to (always) the latest documentation
> (e.g. http://karaf.apache.org/manual/latest/users-guide/index.html)
> # linking from the main page to a page containing a link to all the specific
> docs; e.g. http://karaf.apache.org/manual/latest-2.2.x/users-guide/index.html
> http://karaf.apache.org/manual/latest-2.3.x/users-guide/index.html, ...
> # never delete the manuals, even if we have
> http://karaf.apache.org/manual/latest-9.18.x/users-guide/index.html :-)
> # link to the specific documentations from the release pages of each release
--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators:
https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira
