[Live-demo] Re: [OSGeo] #537: Documentation not up-to-date

[OSGeo]

#537: Documentation not up-to-date
-----------------------+----------------------------------------------------
  Reporter:  pka       |       Owner:  live-demo at lists.osgeo.org
      Type:  defect    |      Status:  closed                   
  Priority:  critical  |   Component:  LiveDVD                  
Resolution:  fixed     |    Keywords:  3.0                      
-----------------------+----------------------------------------------------
Comment (by hamish):

 Replying to [comment:4 camerons]:
 > I've corrected ossim definition.html which pointed to the
 > wrong location.

 spatialite had the same problem.

 This a very good example where by using an ascii-based doc format I could
 check all ~ 31 projects for this error within about 30 seconds of seeing
 the diff in the trac log. It is simply not an efficient use of my time to
 hunt through all wysiwyg files and almost impossible to do a detailed
 heuristic search and replace while preserving formatting. And without the
 diff I would not have known what to look for ... at most I could maintain
 the 3-5 projects I am most interested in without wasting an hour on it.

 This is a matter for the future, but I'm even more convinced now that
 keeping basic getting-started docs in text-based masters is the only way
 to go, with project supplied PDFs for full docs and tutorials (e.g. see
 existing QGIS, GMT, and MB-System manuals/tutorials/cookbooks). The team
 could offer to accept docs in whatever format and convert to PDF or html
 as needed, but that takes at least one volunteer willing to do it. .RTF
 may be another compromise option.


 Hamish

 ps- if someone could explain to me how to fix the hyperlinks in
 grass_description.odt I'd appreciate it. The ones in the .html version in
 svn are correct.

 pps- QGIS installs the following 2 pdfs. Are they the most recent?
 {{{
 qgis-1.0.0_a-gentle-gis-introduction_en.pdf
 qgis-1.3.0_user_guide_en.pdf
 }}}

-- 
Ticket URL: <https://trac.osgeo.org/osgeo/ticket/537#comment:6>
OSGeo <http://www.osgeo.org/>
OSGeo committee and general foundation issue tracker.