[Gluster-devel] Gluster docs stuff?

[Justin Clift]

On 02/09/2013, at 5:44 PM, Vijay Bellur wrote:
> On 08/29/2013 10:43 PM, Justin Clift wrote:
>> Hi Eco,
>> 
>> I'm wanting to create some docs around libgfapi.
>> 
>>   eg Intro to it, basic usage, function descriptions, and some
>>   example (maybe using what's in api/examples)
>> 
>> I'd like to have it all ready (or at least enough of it)
>> in time for my talk on September 10th.
>> 
>> Where do you want me to work on stuff?  In the
>> new site repo here, or somewhere else, or ?
>> 
>>   https://forge.gluster.org/gluster-site/gluster-site/blobs/raw/master/_site/index.html
> 
> Can we possibly host this in a subdomain api.gluster.org or something like that?

Is the idea "something specific to the API's", or are would
a general "docs.gluster.org" type of thing be better?


> Once we have potential native ReST APIs for provisoning, they could be hosted here too?

Hmmm... not sure.  Let's see what I come up with, and lets see
what the native REST API stuff shapes up like, before we go
reserving api.gluster.org for that.  "api.gluster.org" sounds
like we could actually use it for an automated entry point for
something itself (what exactly though... I'm not sure :>)

+ Justin

> -Vijay

--
Open Source and Standards @ Red Hat

twitter.com/realjustinclift