Re: [naviserver-devel] Documentation & website question

[Stephen D. <sd...@gm...>]

I was looking at the docs too.  I installed fedoras tcllib and there's
a doctools lib, but no standalone tool to convert things.  Should
there be? Or where does this live?

Also, how are folks converting the templates to man and html pages? I
can't see any Makefile rules, in the Tcl thread package for example.
Are people just converting by hand and putting the result in CVS?

I dunno about the below -- docs live in
/usr/shar/doc/naviserver-x.x...  I'd like to make things more
standard, not less.

I see the docs in two parts, the man pages, which are a technical
reference, and the HOWTO stuff.  Seems to me like the technical ref
should be kept uptodate with the code, and the HOWTO stuff on the
wiki, where people can, hopefully, update it.

Pointing people in the right direction is a good idea though.  How
about a default start page for the installed server which focusses
more on what to do next, rather than advertising?  Could point to the
installed html version of the docs with a file:/// reference, and the
online wiki for HOWTO stuff, talk about the reference config file, and
the the stats module can be enabled for introspection stuff.

The current index.adp in contrib doesn't mention any docs at all...
Or how t osign up to the mailing list, or how to report a bug, or how
to find modules to install...




On 9/4/06, Vlad Seryakov <vl...@cr...> wrote:
>
> Maybe instead of solving documentation issue technically using
> conversion tools we can just include html pages with all we have docs
> into distributon, like Apache does, once installed we will copy manuals
> under pages so every new install will have access to docs even without
> writing any script. Those docs can have working examples, simple ones or
> complex does not matter but they will perform testing and educational
> tasks at the same time.
> I went through AOlserver site, wiki and our wiki and pieces of docs, it
> is spread and having this simply as html docs in one place may be easier.
>
> Just a thought inspired by thread on AOLserver mailing list:-))
>
> --
> Vlad Seryakov
> 571 262-8608 office
> vl...@cr...
> http://www.crystalballinc.com/vlad/
>
> -------------------------------------------------------------------------
> Using Tomcat but need to do more? Need to support web services, security?
> Get stuff done quickly with pre-integrated technology to make your job easier
> Download IBM WebSphere Application Server v.1.0.1 based on Apache Geronimo
> http://sel.as-us.falkag.net/sel?cmd=lnk&kid=120709&bid=263057&dat=121642
> _______________________________________________
> naviserver-devel mailing list
> nav...@li...
> https://lists.sourceforge.net/lists/listinfo/naviserver-devel
>