[mapguide-internals] making documentation an installer option + docs feedback comments

[Zac Spitzer]

it would be pretty easy to include a small free third partysuch
comment stuff using
htacess, of every just some good old jquery without needing to even
hardly touch
doxygen or something like it. as for moderation, we don't moderate
wiki either yet

I completely agree about pushing these ideas out after the 2.1 release

i'll do some trac'ing next week on this ;)



On Thu, May 21, 2009 at 5:26 AM, Jason Birch <Jason.Birch at nanaimo.ca> wrote:
> I'm feeling incredibly resistant to making non-defect changes to the installer before the 2.1 release; UI sequencing (and testing) is a royal pain in the ass :)  Could you put in a ticket for it so we can address it for the next release?
>
> There are tonnes of other improvements I'd like to see for the install process; I'll have to remember to add tickets for these :)
>
>  - not requiring a reboot (moving default CS_Map folder into a server config item)
>
>  - placing the MapAgent test pages in their own folder, getting the server admin test helper OUT of the viewer directories, making these optional
>
>  - fleshing out the samples options (test data, developer docs, etc)
>
>  - figuring out how to set the Admin / Author passwords at install time
>
> Comments on the online help would not be a trivial task, though I agree that it's cool (the PHP help is another good example of this).  I don't think that Doxygen provides the ability to do this natively, and I'm not sure how static Doxygen file names are, so hacking it in could/would be difficult.  We're also quite limited in what we can do on the primary OSGeo server, so the docs would likely have to be hosted elsewhere.  I also have concerns that we wouldn't have the resources to moderate this kind of system.
>
> Jason
>
> -----Original Message-----
> From: Zac Spitzer
> Sent: Wednesday, May 20, 2009 3:13 AM
> To: MapGuide Internals Mail List
> Subject: [mapguide-internals] making documentation an installer option + docs feedback comments
>
> given there are 8000+ plus files in the help files, would it make sense
> to make the installation of documentation a non default option. 8000 files
> takes while :)
>
> It would make the install a **lot** faster and we can just drop a url link
> into the start menu, most people google first anyway so local doco
>
> for a production server, do we need to be installing documentation?
>
> whilst talking about this
>
> one of the nice features of adobe's online help is the ability to
> add feedback n comments
>
> http://livedocs.adobe.com/coldfusion/8/htmldocs/help.html?content=Tags_g-h_09.html
>
> this would be a nice thing to have for the mapguide doco, what do people think?
>
> z
> _______________________________________________
> mapguide-internals mailing list
> mapguide-internals at lists.osgeo.org
> http://lists.osgeo.org/mailman/listinfo/mapguide-internals
>



-- 
Zac Spitzer -
http://zacster.blogspot.com
+61 405 847 168