[OPEN-ILS-DOCUMENTATION] Supporting Projects/Useful links page in Docos

[Yamil Suarez]

Steve,

This is a good idea and I have needed links like that in the past. Though I would be concerned with the links going bad over time or out of date with the versions actively used by the project. I don't want to discourage anyone, but I wanted to air some basic concerns. I would recommend that when a link is listed, that the title of the page be listed as well, in case the original link goes bad so Google could be used later on to find a mirror page or similar content. I would also suggest that the links list the exact version software targeted, if possible, to help catch if a link needs to be updated in the future. This also makes me think that in a perfect world we should run an link checker on our official docs to catch links that do not work.

Just my two cents,
Yamil

On Aug 17, 2011, at 12:00 PM, open-ils-documentation-request at list.georgialibraries.org wrote:

> 
> ------------------------------
> 
> Message: 2
> Date: Tue, 16 Aug 2011 14:58:08 -0400
> From: Stephen Wills <swills at beyond-print.com>
> Subject: [OPEN-ILS-DOCUMENTATION] Supporting Projects/Useful links
> 	page in	Docos
> To: open-ils-documentation at list.georgialibraries.org
> Message-ID: <3F6BCBA9-D091-45AC-AB46-6140E2B6EE1C at beyond-print.com>
> Content-Type: text/plain; charset=US-ASCII; format=flowed; delsp=yes
> 
> Hi Guys,
> 
> An interesting exchange on IRC today led me to wonder if it would be  
> generally useful for our documentation to have a "Partner Projects"  
> page with useful links on how to work with/tune the underlying projects.
> 
> A partner project would be something like PostgreSQL or eJabberd which  
> have nuances that go beyond what our community can directly support.   
> In the specific context, a question came up around the best  
> configuration for PostgreSQL and the link:
> 
> http://wiki.postgresql.org/wiki/Tuning_Your_PostgreSQL_Server was  
> offered.
> 
> I am sure there are many other useful links that can help beginner and  
> intermediate technicians get a leg up on running their own "total"  
> Evergreen installation.
> 
> What do you think?
> 
> Stev3
> 
> *****************************************************