[dev] documentation folder for applications

Jan Schneider jan at horde.org
Fri Jul 1 15:11:27 UTC 2011


Zitat von Vilius ?umskas <vilius at lnk.lt>:

> Hi,
>
> I've noticed that most released applications install their  
> documentation into /usr/share/pear/doc. Is there another good reason  
> for this except that "all PEAR packages install documentation into  
> pear/doc"? I can justify why this is OK for libraries, but in my  
> opinion INSTALL/UPGRADING documentation for applications should be  
> installed into application root folder. Because it is really  
> uncommon for the administrators to find documentation in  
> /usr/share/pear/doc. Especially for administrators of web  
> applications (even if they are distrubuted through PEAR).

Good question. Policy-wise they should be using the docs role and thus  
being installed to PEAR's doc folder. But I could see us ignoring that  
and using the horde role instead, if that is consensus.

Jan.

-- 
Do you need professional PHP or Horde consulting?
http://horde.org/consulting/



More information about the dev mailing list