[ZOO-PSC] ZOO-Project Documentation process

[Jeff McKenna]

On 11-02-24 6:00 AM, nicolas bozon wrote:
> Hi Jeff, all
>
> Many thanks for sending this summary.
>
> It seems i disagree with your first point:
>
> "existing site will be converted to Sphinx layout"
>
> I think the actual site layout based on Trac and home made soup must not
> change.
>
> According to me, only the /Docs section layout will be converted to
> Sphinx layout and styled with the ZOO CSS (it will also contain the
> general navigation menu for better interaction with all the other sections)
> Is it ok for you ?
>
> I agree with all the other points.

Hello Nick,

Yes as we discussed during the meeting, the plan is to convert the 
existing site into a Sphinx template, so that all of the pages are 
stored in Subversion and restructured text, making it easy to backup the 
content, make changes to any part of the site using simple text files, 
and work offline.  Only the "Trac" link will go to the Wiki, where users 
can contribute documents and notes through the Wiki.

Maybe I can show you what I mean, with a demo on zoo-project 
servers...once you see the nice small rst files for each page stored in 
SVN you may understand better.

-jeff


-- 
Jeff McKenna
MapServer Consulting and Training Services
http://www.gatewaygeomatics.com/