[lsst-dm-stack-users] Confusion over documentation

[Srinivasan Chandrasekharan]

Hi KT,

I am not too well versed with the different views in Confluence. I dont have a comment on the error proneness of the having pages within a space. 

As long as the confusion is addressed I am ok with any solution.

Regards,
Srinivasan Chandrasekharan
Senior Software Engineer,
Large Synoptic Survey Telescope,
National Optical Astronomy Observatory,
Tucson, AZ 85726
(520) 318-8383
schandra at noao.edu




On Sep 19, 2014, at 12:54 PM, Kian-Tat Lim <ktl at slac.stanford.edu> wrote:

> Srini,
> 
>> Its absolutely fine to follow what Confluence is doing for documentation but the Site Spaces might become unwieldy if all software projects ended up publishing their documentation with versions on the Site Space level.
> 
> 	I think the flaw is having Site Spaces as a default view of the
> system.  We should come up with a more useful filtered view, rather than
> restricting the creation of Site Spaces.
> 
>> What I am suggesting is that Site Space level is called “LSST Software User Guide” and one could pages for versioning underneath because I am sure there will be other versions of the LSST Software User Guide that come along.
> 
> 	The problem with doing this underneath the Space level, as I
> said, is that pages have to have unique names within a space.  That
> means that every page has to say, e.g. "Representation of a Camera
> (v7.0)", which is not only ugly (and generally
> URL-and-search-engine-unfriendly) but error-prone.
> 
> -- 
> Kian-Tat Lim, LSST Data Management, ktl at slac.stanford.edu

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://listserv.lsstcorp.org/pipermail/dm-users/attachments/20140919/fec2e6c3/attachment.html>