[dev] [commits] Horde branch master updated. bc5b08ba9bd5b3a0f85bb81687c44c14deee3e89

Vilius Šumskas vilius at lnk.lt
Mon Nov 21 23:05:11 UTC 2011


Michael M Slusarz <slusarz at horde.org> rašė:

> Quoting Jan Schneider <jan at horde.org>:
>
>> Zitat von Michael M Slusarz <slusarz at horde.org>:
>>
>>> But I have other things to fight about.  But whatever we do, we  
>>> have to make sure that the channel-discover line is not wrapped on  
>>> 80-column displays, unlike before.
>>
>> I already didn't understand this the first time. How is that an  
>> issue, beside that it doesn't "look good"? In the website version  
>> this is not an issue, and if you copy and paste it from the  
>> console, there will be no line breaking in the copied code. I think  
>> that's a moot point and since this seems to be the driving issue  
>> for you we should simply revert to the old path.
>
> Because it looks very unprofessional.  One of the ways we stand-out  
> compared with other projects is the detail and presentation of our  
> product.  Going through the INSTALL file, this was an example that,  
> quite frankly, looked like it didn't belong (same thing with a  
> prominent TODO in the DB section.  Stuff like this just makes it  
> look like the project is half-complete.  TODOs need to stay out of  
> user-specific documentation).

As for TODOs, I agree. They are interesting for developers, so should  
stay in PEAR's documentation directories.

Some time ago, I have proposed moving INSTALL and other user-specific  
documentation back to Horde webroot. It is really hard to find even  
for intermediate sysadmins. Especially when PEAR doesn't have a  
unified simple way for accessing documentation. Like for example "man"  
command for other ordinary applications. But, well... there was no  
support from other devs regarding that :)

-- 
   Vilius




More information about the dev mailing list