[Gluster-users] Best Practices for different failure scenarios?

[BGM]

thnx Vijay,
will drill my head into it ....
Bernhard

Sent from my iPad

> On 24.02.2014, at 17:26, Vijay Bellur <vbellur at redhat.com> wrote:
> 
> On 02/21/2014 10:27 PM, BGM wrote:
>>>> It might be very helpful to have a wiki next to this mailing list,
>>>> where all the good experience, all the proved solutions for "situations"
>>>> that are brought up here, could be gathered in a more
>>>> permanent and straight way.
>>> 
>>> +1. It would be very useful to evolve an operations guide for GlusterFS.
>>> 
>>>> .
>>>> To your questions I would add:
>>>> what's best practice in setting options for performance and/or integrity...
>>>> (yeah, well, for which use case under which conditions)
>>>> a mailinglist is very helpful for adhoc probs and questions,
>>>> but it would be nice to distill the knowledge into a permanent, searchable form.
>>>> .
>>>> sure anybody could set up a wiki, but...
>>>> it would need the acceptance and participation of an active group
>>>> to get best results.
>>>> so IMO the appropriate place would be somewhere close to gluster.org?
>>>> .
>>> 
>>> Would be happy to carry this in doc/ folder of glusterfs.git and collaborate on it if a lightweight documentation format like markdown or asciidoc is used for evolving this guide.
>> 
>> I haven't worked with neither of them,
>> on the very first glance asciidoc looks easier to me.
>> (assuming it is either or ?)
>> and (sorry for being flat, i m op not dev ;-) you suggest everybody sets up a git from where you
>> pull, right?
> 
> No need to setup a git on your own. We use the development workflow [1] for submitting patches to documentation too.
> 
>> well, wouldn't a wiki be much easier? both, to contribute to and to access the information?
>> (like wiki.debian.org?)
>> The git based solution might be easier to start of with,
>> but would it reach a big enough community?
> 
> Documentation in markdown or asciidoc is rendered well by github. One of the chapters in our admin guide does get rendered like this [2].
> 
>> Wouldn't a wiki also have a better PR/marketing effect (by being easier to access)?
>> just a thought...
> 
> We can roll out the content from git in various formats (like pdf, html etc.) as both asciidoc/markdown can be converted to various formats. The advantage of a git based workflow is that it becomes easy to review changes through tools like gerrit and can also help in keeping false content/spam out of the way.
> 
> Having said that, feel free to use tools of your choice. We can just go ahead and use whatever is easy for most of us :). At the end of the day, evolving this guide is more important than the tools that we choose to use in the process.
> 
> Cheers,
> Vijay
> 
> [1] http://www.gluster.org/community/documentation/index.php/Development_Work_Flow
> 
> [2] https://github.com/gluster/glusterfs/blob/master/doc/admin-guide/en-US/markdown/admin_setting_volumes.md
> 
> 
>> Bernhard
>> 
>>> 
>>> -Vijay
>