[GRASS-dev] [GRASS GIS] #3977: Offer canonical non changing links to always current documentation

GRASS GIS trac at osgeo.org
Mon Nov 18 01:08:43 PST 2019


#3977: Offer canonical non changing links to always current documentation
-------------------------+-------------------------
 Reporter:  jidanni      |      Owner:  grass-dev@…
     Type:  enhancement  |     Status:  new
 Priority:  normal       |  Milestone:
Component:  Website      |    Version:  unspecified
 Keywords:               |        CPU:  Unspecified
 Platform:  Unspecified  |
-------------------------+-------------------------
 Let's say we were reading
  file:///usr/share/doc/grass-doc/html/d.erase.html
 offline.

 Well wouldn't it be great if within it there was a link to
  https://grass.osgeo.org/grass79/manuals/d.erase.html

 Such a link could have many uses:
 Let's say we were composing a email offline, and wanted to refer to that
 page, but didn't want to go online just yet to check the URL.

 Or let's say we were composing a bug report offline, and wanted to make
 sure it was useful when later posted online.

 In fact, instead of
  https://grass.osgeo.org/grass79/manuals/d.erase.html
 how about just
  https://grass.osgeo.org/grass/manuals/d.erase.html
 and hyperlink it as
 "Permalink to this [d.erase, etc.] man page".

 Yes, grass.osgeo.org needs to offer permalinks to these documentation
 items. OK, call them canonical links or something.

 You see users are tearing their hair out wanting to simply tell their
 friends about a certain man page, without having to worry that it will
 gradually get stale, and finally disappear.

 Sure, if they really want to link to a certain version of a man page,
 for use in a court of law, then they can still use the current numbered

-- 
Ticket URL: <https://trac.osgeo.org/grass/ticket/3977>
GRASS GIS <https://grass.osgeo.org>



More information about the grass-dev mailing list