[Gluster-users] Disappointing documentation?

[Joe Julian]

No, that pdf's done in docbook and there's no clean conversion to 
mediawiki. Someone was copy-pasting (often with errors) from the pdf 
into the wiki.

Somewhere along the way, the decision was made to only have an 
un-editable pdf as the only form of documentation provided by Gluster 
during the transition from their own company to being owned by Red Hat. 
I've fought and complained ever since. That's why I'm trying to start 
converting it to asciidoc and having it hosted outside the source tree. 
Not only, then, can there be a pdf, but other formats are easily 
accessible from there as well and we can all participate.

On 03/06/2013 01:54 PM, Pierre-Francois Laquerre wrote:
> On 03/05/2013 05:46 PM, Papp Tamas wrote:
>> There is no online documentation for v3.3. Every google search points to
>> http://gluster.org/community/documentation/index.php/Gluster_3.2_Filesystem_Administration_Guide 
>>
>>
>>
>> There is an Admin guide, but it's in pdf and html gzipped? Is it fun?:)
>
> This is one of my main gripes with the 3.3 documentation as well: it's 
> not indexed anywhere. I constantly have to pull up the admin guide 
> pdf, and hope that the term I am searching for doesn't have a \n in 
> the middle (try to find "flush-behind" in it to see what I mean).
>
> Is there a reason why the 3.3 admin guide isn't on the wiki, like 3.2 
> and 3.1? I always assumed that the pdfs were just an automatic 
> conversion of the wiki to pdf format in the first place.