You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 3 Next »

Issues to resolve

  • How to deal with multiple versions of the site
  • How to deal with staging directories for the site (will require a change to the POM)

Note from brett:

I think I've got this filed away somewhere in m1.

Basically, the key should be to separate documentation from site - where documentation is versioned and distributed, and the site is not (the documentation is likely still rendered HTML, however).

Either might also link to another version of the doco - to the extent of "this version" and "latest".

Also, developer documentation should be segregated from user documentation. I believe this should be acheived by defining arbitrary categories for site content so that reports can also be filed under those categories (allowing design docs, javadoc and clover to go to the dev doco, but user guides, project info and faqs , etc to go to the user section).

JIRA reference

  • No labels