cocoon-docs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject [Cocoon Wiki] Updated: CocoonDocumentationSystem
Date Wed, 19 Jan 2005 06:36:22 GMT
   Date: 2005-01-18T22:36:22
   Editor: DavidCrossley
   Wiki: Cocoon Wiki
   Page: CocoonDocumentationSystem

   add para about publishing

Change Log:

@@ -224,3 +224,5 @@
 Please use ''italics'' to add comments above this line, or write more extensive comments
and ideas below.
  * Tagging documents with simple free-form keywords, as done for links on []
or pictures on [] is a very powerful yet simple way of providing many
useful navigation paths in the documentation. Even if tag-based navigation is not implemented
right away, it would be good to add tags (like "sitemap config FileGenerator Generator 2.1.1"
for example) when revising existing documents, as opposed to having to revisit all documents
later on to tag them. - [wiki:BertrandDelacretaz BD]
+ * There are many hurdles with the publishing process. The main issues are that websites
need to be easily recoverable after a potential calamity (hence the current practice of commit
generated docs to VCS) and that committers need to be responsible for the various actions
(automated is considered bad). Not saying that this is the answer, but see [
Draft: Proposal for ASF-wide documentation staging and publishing] - [wiki:DavidCrossley DC]

View raw message