This is the requirements document for the ESD Software Engineering Group's Unix Web Site Re-organization.
General Requirements, Specific Requirements,
and group those together to form an outline of the major sections of web site we should have. Then create this organization hierarchically from the main homepage at afs/slac/g/cd/soft/html/index.html.
Give the Software Group write access to the Web pages, so documentation can easily be updated. This will depend on the ACL in each directory under afs/slac/g/cd/soft/html/. The ACL is probably the same for each subdirectory of afs/slac/g/cd/soft/html/, but still check what ACLs are there, and whether everyone in the software group is able to write to those directories.
Move control-system detailed operational pages to /afs/slac/g/cd/soft/htm/slaconly, and fix links. Pages which should be moved are those that include nodenames, like "opi00gtw00", or "MCC.SLAC.STANFORD.EDU". This may well entail finding all references to those pages and changing the link!
Our software releases pages (http://www.slac.stanford.edu/cgi-bin/lwgate/CDSOFT-SW-RELEASES/archives/ and below are such pages that have node names and should be moved to slac-only. This is a cgi system, so moving it may not be trivial).
These directories will be the default locations of such documents on unix, if there is no other project subdirectory in which they should be located, or before that project subdirectory exists.
A complementary set of directories should be created on our Windows web server, to act similarly as the default repository location for Windows file format documents, such as Word and Excel files.
Check whether we need both a CD_SOFT/html/slaconly and a CD_SOFT/html/share/slaconly. Why do we have these two. If there's no good reason, amalgamte them under just CD_SOFT/html/slaconly and fix the links. Note, slaconly in the pathname tells the web server not to let anyone from outside SLAC access the page. Seems like we don't need both slaconlys though.
When project specific html directories do exist, soft links should be
created from these directories to those corresponding subdirectories of each
project, so for instance $CD_SOFT/html/req/cmlog is a soft link which points
to the directory $CD_SOFT/html/cmlog/req/.
Write a Users' Guide to ESD Software Group Web Site. This should include:
Writing on XP, and publishing to the Unix web space under /afs/slac/g/cd/soft/html. This will probably use WebDAV as the enabling technology. Include explicit instructions for Word and FrontPage and Netscape Composer. Write this as if the user has AFS installed on their XP.
Writing on Unix and publishing to Unix web space under /afs/slac/g/cd/soft/html. Include explicit instructions for Netscape Composer.
[Topic Home Page][SLAC ESD Software Engineering Group][ SLAC Home Page]
Author: Greg White, 03-Feb-2003