You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@cloudstack.apache.org by David Grizzanti <da...@sungard.com> on 2013/03/18 21:04:45 UTC

[DOC] Help with updating Install Guide sections needed

Hi All,

I'm looking to convert a few of the leftover sections of the Install Guide (pre-Apache) into XML and incorporate into the new documentation format.  Outside of a straight conversion, a few of the documents require some review in order to bring the documentation up to date.

For each section, I'm looking for someone who would be willing to serve as an "expert" that I can ask to review and gather any new information from.

Here are the sections I need help on (the Jira has a word doc associated with the documentation in question attached):
- Global Configuration Settings (https://issues.apache.org/jira/browse/CLOUDSTACK-1598)
- Storage Setup (https://issues.apache.org/jira/browse/CLOUDSTACK-1597)
- Choosing a Hypervisor (https://issues.apache.org/jira/browse/CLOUDSTACK-1596)
- Best Practices (https://issues.apache.org/jira/browse/CLOUDSTACK-1599)

If anyone has any interest or would be willing to help out, please let me know!

Thanks

-- 
David Grizzanti
Software Engineer - SunGard Availability Services
401 N. Broad Street, Philadelphia, PA 19108
o: 215-446-1431 - e: david.grizzanti@sungard.com

Re: [DOC] Help with updating Install Guide sections needed

Posted by Chip Childers <ch...@sungard.com>.
On Wed, Mar 20, 2013 at 03:06:31PM -0400, David Grizzanti wrote:
> Chip/David,
> 
> Sounds good to me.  I've seen emails in the past that go to both lists (-dev and -users).  In this case would it be a good idea to draft an email per topic and send out 1 email that copies both lists?

I'd just go straight to the users list to ask for the review.  If you
get silence, then do it again on dev and we'll nudge relevant folks.

Re: [DOC] Help with updating Install Guide sections needed

Posted by David Grizzanti <da...@sungard.com>.
Chip/David,

Sounds good to me.  I've seen emails in the past that go to both lists (-dev and -users).  In this case would it be a good idea to draft an email per topic and send out 1 email that copies both lists?

I'll get started on the conversions and then on the discussions after that.

Thanks,

On Mar 20, 2013, at 12:30 PM, David Nalley wrote:

> On Wed, Mar 20, 2013 at 12:06 PM, Chip Childers
> <ch...@sungard.com> wrote:
>> Scratch that - Sorry Jessica / Radhika.
>> 
>> David's looking for technical reviewers.
>> 
>> David -- I think that the challenge here is that the actual material
>> for each of those docs is very broad.  Perhaps the right way to
>> approach this is to attempt the fix, submit it, and initiate a content
>> discussion (per topic) on the dev list.  We can also consider asking
>> for content reviews from cloustack-users@i.a.o, given that best
>> practices, choosing a HV, etc...  are all things the the user
>> community may be qualified to help with.
> 
> 
> That strategy worked very well for me recently - providing a chunk of
> documentation for folks to review on -users found tons of problems
> that I personally missed.
> 
> --David
>

Re: [DOC] Help with updating Install Guide sections needed

Posted by David Nalley <da...@gnsa.us>.
On Wed, Mar 20, 2013 at 12:06 PM, Chip Childers
<ch...@sungard.com> wrote:
> Scratch that - Sorry Jessica / Radhika.
>
> David's looking for technical reviewers.
>
> David -- I think that the challenge here is that the actual material
> for each of those docs is very broad.  Perhaps the right way to
> approach this is to attempt the fix, submit it, and initiate a content
> discussion (per topic) on the dev list.  We can also consider asking
> for content reviews from cloustack-users@i.a.o, given that best
> practices, choosing a HV, etc...  are all things the the user
> community may be qualified to help with.


That strategy worked very well for me recently - providing a chunk of
documentation for folks to review on -users found tons of problems
that I personally missed.

--David

Re: [DOC] Help with updating Install Guide sections needed

Posted by Chip Childers <ch...@sungard.com>.
Scratch that - Sorry Jessica / Radhika.

David's looking for technical reviewers.

David -- I think that the challenge here is that the actual material
for each of those docs is very broad.  Perhaps the right way to
approach this is to attempt the fix, submit it, and initiate a content
discussion (per topic) on the dev list.  We can also consider asking
for content reviews from cloustack-users@i.a.o, given that best
practices, choosing a HV, etc...  are all things the the user
community may be qualified to help with.

Sound OK?

On Wed, Mar 20, 2013 at 11:59 AM, Chip Childers
<ch...@sungard.com> wrote:
> Jessica / Radhika,
>
> Can you answer any of David's questions?
>
> On Mon, Mar 18, 2013 at 04:04:45PM -0400, David Grizzanti wrote:
>> Hi All,
>>
>> I'm looking to convert a few of the leftover sections of the Install Guide (pre-Apache) into XML and incorporate into the new documentation format.  Outside of a straight conversion, a few of the documents require some review in order to bring the documentation up to date.
>>
>> For each section, I'm looking for someone who would be willing to serve as an "expert" that I can ask to review and gather any new information from.
>>
>> Here are the sections I need help on (the Jira has a word doc associated with the documentation in question attached):
>> - Global Configuration Settings (https://issues.apache.org/jira/browse/CLOUDSTACK-1598)
>> - Storage Setup (https://issues.apache.org/jira/browse/CLOUDSTACK-1597)
>> - Choosing a Hypervisor (https://issues.apache.org/jira/browse/CLOUDSTACK-1596)
>> - Best Practices (https://issues.apache.org/jira/browse/CLOUDSTACK-1599)
>>
>> If anyone has any interest or would be willing to help out, please let me know!
>>
>> Thanks
>>
>> --
>> David Grizzanti
>> Software Engineer - SunGard Availability Services
>> 401 N. Broad Street, Philadelphia, PA 19108
>> o: 215-446-1431 - e: david.grizzanti@sungard.com
>>

Re: [DOC] Help with updating Install Guide sections needed

Posted by David Grizzanti <da...@sungard.com>.
Ok, sounds good to me.

Radhika - I'll ping you offline when I need more info.

Thanks again,

On Mar 21, 2013, at 12:31 AM, Radhika Puthiyetath wrote:

> Hi Chip,
> 
> I am not an SME for any of these sections. However, I can help David direct to the right contact.
> 
> Thanks
> -Radhika
> 
> -----Original Message-----
> From: Chip Childers [mailto:chip.childers@sungard.com] 
> Sent: Wednesday, March 20, 2013 9:29 PM
> To: cloudstack-dev@incubator.apache.org
> Cc: Jessica Tomechak; Radhika Puthiyetath
> Subject: Re: [DOC] Help with updating Install Guide sections needed
> 
> Jessica / Radhika,
> 
> Can you answer any of David's questions?
> 
> On Mon, Mar 18, 2013 at 04:04:45PM -0400, David Grizzanti wrote:
>> Hi All,
>> 
>> I'm looking to convert a few of the leftover sections of the Install Guide (pre-Apache) into XML and incorporate into the new documentation format.  Outside of a straight conversion, a few of the documents require some review in order to bring the documentation up to date.
>> 
>> For each section, I'm looking for someone who would be willing to serve as an "expert" that I can ask to review and gather any new information from.
>> 
>> Here are the sections I need help on (the Jira has a word doc associated with the documentation in question attached):
>> - Global Configuration Settings (https://issues.apache.org/jira/browse/CLOUDSTACK-1598)
>> - Storage Setup (https://issues.apache.org/jira/browse/CLOUDSTACK-1597)
>> - Choosing a Hypervisor (https://issues.apache.org/jira/browse/CLOUDSTACK-1596)
>> - Best Practices (https://issues.apache.org/jira/browse/CLOUDSTACK-1599)
>> 
>> If anyone has any interest or would be willing to help out, please let me know!
>> 
>> Thanks
>> 
>> -- 
>> David Grizzanti
>> Software Engineer - SunGard Availability Services
>> 401 N. Broad Street, Philadelphia, PA 19108
>> o: 215-446-1431 - e: david.grizzanti@sungard.com
>> 
>

RE: [DOC] Help with updating Install Guide sections needed

Posted by Radhika Puthiyetath <ra...@citrix.com>.
Hi Chip,

I am not an SME for any of these sections. However, I can help David direct to the right contact.

Thanks
-Radhika

-----Original Message-----
From: Chip Childers [mailto:chip.childers@sungard.com] 
Sent: Wednesday, March 20, 2013 9:29 PM
To: cloudstack-dev@incubator.apache.org
Cc: Jessica Tomechak; Radhika Puthiyetath
Subject: Re: [DOC] Help with updating Install Guide sections needed

Jessica / Radhika,

Can you answer any of David's questions?

On Mon, Mar 18, 2013 at 04:04:45PM -0400, David Grizzanti wrote:
> Hi All,
> 
> I'm looking to convert a few of the leftover sections of the Install Guide (pre-Apache) into XML and incorporate into the new documentation format.  Outside of a straight conversion, a few of the documents require some review in order to bring the documentation up to date.
> 
> For each section, I'm looking for someone who would be willing to serve as an "expert" that I can ask to review and gather any new information from.
> 
> Here are the sections I need help on (the Jira has a word doc associated with the documentation in question attached):
> - Global Configuration Settings (https://issues.apache.org/jira/browse/CLOUDSTACK-1598)
> - Storage Setup (https://issues.apache.org/jira/browse/CLOUDSTACK-1597)
> - Choosing a Hypervisor (https://issues.apache.org/jira/browse/CLOUDSTACK-1596)
> - Best Practices (https://issues.apache.org/jira/browse/CLOUDSTACK-1599)
> 
> If anyone has any interest or would be willing to help out, please let me know!
> 
> Thanks
> 
> -- 
> David Grizzanti
> Software Engineer - SunGard Availability Services
> 401 N. Broad Street, Philadelphia, PA 19108
> o: 215-446-1431 - e: david.grizzanti@sungard.com
>

Re: [DOC] Help with updating Install Guide sections needed

Posted by Chip Childers <ch...@sungard.com>.
Jessica / Radhika,

Can you answer any of David's questions?

On Mon, Mar 18, 2013 at 04:04:45PM -0400, David Grizzanti wrote:
> Hi All,
> 
> I'm looking to convert a few of the leftover sections of the Install Guide (pre-Apache) into XML and incorporate into the new documentation format.  Outside of a straight conversion, a few of the documents require some review in order to bring the documentation up to date.
> 
> For each section, I'm looking for someone who would be willing to serve as an "expert" that I can ask to review and gather any new information from.
> 
> Here are the sections I need help on (the Jira has a word doc associated with the documentation in question attached):
> - Global Configuration Settings (https://issues.apache.org/jira/browse/CLOUDSTACK-1598)
> - Storage Setup (https://issues.apache.org/jira/browse/CLOUDSTACK-1597)
> - Choosing a Hypervisor (https://issues.apache.org/jira/browse/CLOUDSTACK-1596)
> - Best Practices (https://issues.apache.org/jira/browse/CLOUDSTACK-1599)
> 
> If anyone has any interest or would be willing to help out, please let me know!
> 
> Thanks
> 
> -- 
> David Grizzanti
> Software Engineer - SunGard Availability Services
> 401 N. Broad Street, Philadelphia, PA 19108
> o: 215-446-1431 - e: david.grizzanti@sungard.com
>