Forum OpenACS Q&A: Re: URLs of most current documentation: moving targets

Collapse
2: Re: URLs of most current documentation: moving targets (response to 1)
Posted by Jade Rubick on 06/09/03 07:52 PM
This is a good idea!
Collapse
3: Re: URLs of most current documentation: moving targets (response to 2)
Posted by Joel Aufrecht on 06/10/03 12:58 AM
so https://openacs.org/doc/openacs would always return the most recent doc?  Is there a consistent scheme we could use for other docs?  /doc/installed?  /doc/dotlrn?
Collapse
4: Re: URLs of most current documentation: moving targets (response to 3)
Posted by Carl Robert Blesius on 06/10/03 03:33 PM
No, https://openacs.org/doc/ should always be the newest version of the doucmentation. If there is a good reason to create an archived version (e.g. 3 -> 4 or prejoelian docs -> joelian docs) then we create one here: https://openacs.org/openacs-n and add a link to the doc index that is distributed with all versions of OpenACS. This can happen on its own if we commit to keeping the openacs.org cvs in sync with the stable branch of openacs. We then add to the package documentation as usual (e.g. /doc/dotlrn/ ) and benefit from having static urls (e.g. general comments) Here is a suggestion of how the left column in the doc index page could change to reflect this (and replace the page that comes up now): 
Getting Started
        - OpenACS 4.6.3 Release Notes
	- Required Software
	- Unix Installation Guide
        - Windows Installation Guide
	- Mac OS X Installation Guide
	- Upgrading
	- Developer Tutorial
        - API Browser for this OpenACS instance

Full Table of Contents

Primers and References
        - OpenACS FAQs
        - OpenACS CVS Browser
        - AOLserver Documentation 
	  (the Tcl Developer's Guide in particular.)
        - Tcl for Web Nerds
        - SQL for Web Nerds

Archive
        - OpenACS 4.6.2 Documentation
        - OpenACS 4.6 Documentation
        - OpenACS 3.2.5 Documentation

Documentation Improvement Project
        - Help improve OpenACS documentation
Collapse
5: Re: URLs of most current documentation: moving targets (response to 3)
Posted by Joel Aufrecht on 06/11/03 12:22 AM
That sounds like a good idea to me.  I'll adjust the /packages/acs-core-docs/www/index.adp page to reflect the extra links, which is a good idea anyway.  Implementation should mean creating a symlink - it would be nice if openacs.org ran on straight code, but that's going to take a while and shouldn't hold up these sorts of improvements.  So I think we can just roll this out with the next dot-release or, I guess, any time after the new index page is ready.  The only drawback is we lose edit-this-page ability on openacs.org/doc.
Collapse
6: Re: URLs of most current documentation: moving targets (response to 5)
Posted by Carl Robert Blesius on 06/11/03 09:37 AM

Think of losing etp ability as a reduction of what we have to worry about. Consequently I am going to start pushing the different pieces of .LRN documentation floating around in etp (and elsewhere) into the /doc/dotlrn/ folder (under cvs control) and pushing descriptions of functionalities that are not specific to .LRN into the individual package docs (news, faq, forums, etc.).

Below is the html for the index page again (I closed an open html tag in the original and added the education link). Now the only thing missing from the old page is "Miscellaneous Documentation" (which only contains an openacs migration doc) and "Using CVS". Where do those two docs belong? 

Getting Started
        - OpenACS 4.6.3 Release Notes
	- Required Software
	- Unix Installation Guide
        - Windows Installation Guide
	- Mac OS X Installation Guide
	- Upgrading
	- Developer Tutorial
        - API Browser for this OpenACS instance

Full Table of Contents Primers and References
        - OpenACS FAQs
        - Learning OpenACS
        - OpenACS CVS Browser
        - AOLserver Documentation 
	  (the Tcl Developer's Guide in particular.)
        - Tcl for Web Nerds
        - SQL for Web Nerds

Archive
        - OpenACS 4.6.2 Documentation
        - OpenACS 4.6 Documentation
        - OpenACS 3.2.5 Documentation

Documentation Improvement Project
        - Help improve OpenACS documentation