I like that idea a lot.  We use docbook to generate most of the toolkit's web 
content.  We'll have to think through if and where taking on a transition like 
that would make sense.  Maybe there are some GT pages that are best left to be 
generated via docbook and some that could be changed to become wiki pages.

For example, I'm thinking (partially based on the input here) that the install 
and quick start might be good candidates to be wiki pages.
        http://www.globus.org/toolkit/docs/latest-stable/admin/install/#gtadmin
        
http://www.globus.org/toolkit/docs/latest-stable/admin/quickstart/#quickstart

Maybe this developer guide too?
        http://www.globus.org/toolkit/docs/5.2/5.2.2/appendices/developer/

Thoughts?

-Stu

On Oct 19, 2012, at Oct 19, 6:09 AM, Pete Eby wrote:

> Has the idea of placing the documentation on a wiki where it could be
> updated by community members been discussed? Perhaps by users with a
> Globus Online login?
> 
> Pete
> 
> On Wed, Oct 17, 2012 at 10:58 AM, Stuart Martin <smar...@mcs.anl.gov> wrote:
>> Hi John,
>> 
>> Thanks for your thoughts.  We'll look to improve the GT doc based on your 
>> feedback.
>>        http://jira.globus.org/browse/GT-305
>> 
>> Cheers,
>> Stu
>> 
>> On Oct 17, 2012, at Oct 17, 8:58 AM, john alexander sanabria ordonez wrote:
>> 
>>> Hello,
>>> 
>>> I did try to follow the instructions given in the Globus Toolkit 
>>> documentation web page but I found a couple of gaps that mislead the 
>>> deployment of basic grid services (simpleCA + gram5 + gridftp), e.g.
>>>      • The documentation does not mention that the grid-ca-certs package 
>>> should be installed
>>>      • The documentation can be more specific about the grid-ca-create 
>>> command must be run by the globus user
>>>      • When this command is run by globus user some files (found in 
>>> ~/.globus/simpleCA) must be copied to the /etc/grid-security directory
>>>      • The documentation should provide a hint which describes what [YUM 
>>> and OSG specific] repositories should be installed for setting up a machine 
>>> where Globus services  would be provisioned 
>>> (https://twiki.grid.iu.edu/bin/view/Documentation/Release3/YumRepositories)
>>> 
>>> I have to thank to Marco Mambelli and Jose Caballero for their hints that 
>>> allow me to define the correct set of steps for installing those services.
>>> 
>>> Regards,
>>> 
>>> PS:  I wrote some Chef recipes which allow to deploy the aforementioned 
>>> services in a physical or virtual machine
>> 

Reply via email to