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, 
[email protected] wrote:

> 
> ------------------------------
> 
> Message: 2
> Date: Tue, 16 Aug 2011 14:58:08 -0400
> From: Stephen Wills <[email protected]>
> Subject: [OPEN-ILS-DOCUMENTATION] Supporting Projects/Useful links
>       page in Docos
> To: [email protected]
> Message-ID: <[email protected]>
> 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
> 
> *****************************************************

_______________________________________________
OPEN-ILS-DOCUMENTATION mailing list
[email protected]
http://list.georgialibraries.org/mailman/listinfo/open-ils-documentation

Reply via email to