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

Collapse
Posted by Joel Aufrecht on
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.

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