You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@cloudstack.apache.org by Ron Wheeler <rw...@artifact-software.com> on 2015/11/02 22:59:48 UTC
Re: Git with Eclipse
Due to Sebastien and Daan's help, I have been able to create a pull
request for a small change to the docs.
https://wiki.eclipse.org/EGit/User_Guide#Working_with_remote_Repositories was
also a great help.
It took me a few attempts to get a push to my github repo working but it
finally worked.
Eclipse/STS is pretty good for editing docs since it has an ReST editor
that provides an outline for documents.
I would like to have a Maven plug-in for Sphinx but I am not sure about
everyone else so it might be tricky to integrate it into my workflow
without affecting the master on git.
If anyone has a chance to look at the pull request and let me know if I
got it right, that would be reassuring.
Ron
On 30/10/2015 5:58 AM, Sebastien Goasguen wrote:
> Ron,
>
> I don’t know how to use Github with eclipse, I use the command line for everything.
>
> But the documentation should be good:
> https://github.com/apache/cloudstack-docs-admin#contributing-to-the-documentation
>
> Basically you need an account on GitHub.
> You fork https://github.com/apache/cloudstack-docs-admin (or the other docs repo).
> You will then have a fork at https://github.com/<YOUR_ACCOUNT>/cloudstack-docs-admin
>
> Clone your own fork:
>
> $ git clone https://github.com/<YOUR_ACCOUNT>/cloudstack-docs-admin
>
> Make your commits via eclipse and push to your own fork.
>
> Then on the GitHub UI, create a pull request to the upstream repo:
> https://github.com/apache/cloudstack-docs-admin
>
> -sebastien
>
>> On Oct 29, 2015, at 9:58 PM, Ron Wheeler <rw...@artifact-software.com> wrote:
>>
>> Trying to help out with the docs without doing too much damage.
>> I am new to git.
>>
>> I am using Eclipse with the egit/mylyn plug-in and I have managed to get the source for the docs-admin downloaded.
>>
>> The "Configure Fetch" has a Source Ref of "refs/heads/*" and a Desctination Ref of "refs/remotes/origin/*"
>> I think that I have the right sources. They seem to match the published docs.
>>
>> I have made my changes and think that I need to create a pull request to get one of the Cloudstack gods to decide if my attempts are worthy.
>>
>> I have created the pull request in Eclipse but when I try to submit it I get an error box titled "Submit failed" popping up with the rather cryptic "Unexpected error: Invalid request. "base", "head" weren't supplied".
>> I think that I have to configure the "Remotes/origin/https://gethub.com/apache/cloudstack-doc-admin.git" entry using "Configure Push" menu.
>>
>> It has a section called "Ref mappings" that I gather is how git figures out how I want my changes mapped back into the remote repos.
>>
>> Am I looking in the right places?
>> If so, what are the right "Source Ref" and "Destination Ref" entries to get a pull request that will please the gods (both local and remote).
>>
>> It looks like editing and creating pull requests gets easy once this is working.
>>
>> Still have to work on getting the document production working so I can actually see the fruits of my labour.
>>
>> Thanks
>>
>> Ron
>>
>>
>> *
>> *
>>
>> --
>> Ron Wheeler
>> President
>> Artifact Software Inc
>> email: rwheeler@artifact-software.com
>> skype: ronaldmwheeler
>> phone: 866-970-2435, ext 102
>>
>
--
Ron Wheeler
President
Artifact Software Inc
email: rwheeler@artifact-software.com
skype: ronaldmwheeler
phone: 866-970-2435, ext 102
Re: Git with Eclipse
Posted by Ron Wheeler <rw...@artifact-software.com>.
Thanks for the feedback.
It is just a small change to see if I can get the process to work.
It is an attempt to clarify a section that I found a bit hard to
understand so I hope that it does make that section easier to read for
the next person.
There is a lot more information in the 4.4 Design Docs which includes
changes made in the 4.5 release which is a bit confusing.
I am not sure how important this stuff is and wonder if some of the
material about GPUs needs to be included in the Admin documentation as a
statement of how they work in the current version rather than asking
people to search through all of the design notes to find out how GPUs
are handled .
Ron
On 03/11/2015 4:36 AM, Daan Hoogland wrote:
> never mind: https://github.com/apache/cloudstack-docs-admin/pull/31/files
>
> looked in the wrong repo
>
> On Tue, Nov 3, 2015 at 10:34 AM, Daan Hoogland <da...@gmail.com>
> wrote:
>
>> Ron, can you link us to your PR? there is 118 open at the moment and I
>> don't see your name with the last bunch.
>>
>> On Mon, Nov 2, 2015 at 10:59 PM, Ron Wheeler <
>> rwheeler@artifact-software.com> wrote:
>>
>>> Due to Sebastien and Daan's help, I have been able to create a pull
>>> request for a small change to the docs.
>>> https://wiki.eclipse.org/EGit/User_Guide#Working_with_remote_Repositories
>>> was also a great help.
>>> It took me a few attempts to get a push to my github repo working but it
>>> finally worked.
>>>
>>> Eclipse/STS is pretty good for editing docs since it has an ReST editor
>>> that provides an outline for documents.
>>> I would like to have a Maven plug-in for Sphinx but I am not sure about
>>> everyone else so it might be tricky to integrate it into my workflow
>>> without affecting the master on git.
>>>
>>> If anyone has a chance to look at the pull request and let me know if I
>>> got it right, that would be reassuring.
>>>
>>> Ron
>>>
>>>
>>>
>>>
>>>
>>> On 30/10/2015 5:58 AM, Sebastien Goasguen wrote:
>>>
>>>> Ron,
>>>>
>>>> I don’t know how to use Github with eclipse, I use the command line for
>>>> everything.
>>>>
>>>> But the documentation should be good:
>>>>
>>>> https://github.com/apache/cloudstack-docs-admin#contributing-to-the-documentation
>>>>
>>>> Basically you need an account on GitHub.
>>>> You fork https://github.com/apache/cloudstack-docs-admin (or the other
>>>> docs repo).
>>>> You will then have a fork at https://github.com/
>>>> <YOUR_ACCOUNT>/cloudstack-docs-admin
>>>>
>>>> Clone your own fork:
>>>>
>>>> $ git clone https://github.com/<YOUR_ACCOUNT>/cloudstack-docs-admin
>>>>
>>>> Make your commits via eclipse and push to your own fork.
>>>>
>>>> Then on the GitHub UI, create a pull request to the upstream repo:
>>>> https://github.com/apache/cloudstack-docs-admin
>>>>
>>>> -sebastien
>>>>
>>>> On Oct 29, 2015, at 9:58 PM, Ron Wheeler <rw...@artifact-software.com>
>>>>> wrote:
>>>>>
>>>>> Trying to help out with the docs without doing too much damage.
>>>>> I am new to git.
>>>>>
>>>>> I am using Eclipse with the egit/mylyn plug-in and I have managed to
>>>>> get the source for the docs-admin downloaded.
>>>>>
>>>>> The "Configure Fetch" has a Source Ref of "refs/heads/*" and a
>>>>> Desctination Ref of "refs/remotes/origin/*"
>>>>> I think that I have the right sources. They seem to match the published
>>>>> docs.
>>>>>
>>>>> I have made my changes and think that I need to create a pull request
>>>>> to get one of the Cloudstack gods to decide if my attempts are worthy.
>>>>>
>>>>> I have created the pull request in Eclipse but when I try to submit it
>>>>> I get an error box titled "Submit failed" popping up with the rather
>>>>> cryptic "Unexpected error: Invalid request. "base", "head" weren't
>>>>> supplied".
>>>>> I think that I have to configure the "Remotes/origin/
>>>>> https://gethub.com/apache/cloudstack-doc-admin.git" entry using
>>>>> "Configure Push" menu.
>>>>>
>>>>> It has a section called "Ref mappings" that I gather is how git figures
>>>>> out how I want my changes mapped back into the remote repos.
>>>>>
>>>>> Am I looking in the right places?
>>>>> If so, what are the right "Source Ref" and "Destination Ref" entries to
>>>>> get a pull request that will please the gods (both local and remote).
>>>>>
>>>>> It looks like editing and creating pull requests gets easy once this is
>>>>> working.
>>>>>
>>>>> Still have to work on getting the document production working so I can
>>>>> actually see the fruits of my labour.
>>>>>
>>>>> Thanks
>>>>>
>>>>> Ron
>>>>>
>>>>>
>>>>> *
>>>>> *
>>>>>
>>>>> --
>>>>> Ron Wheeler
>>>>> President
>>>>> Artifact Software Inc
>>>>> email: rwheeler@artifact-software.com
>>>>> skype: ronaldmwheeler
>>>>> phone: 866-970-2435, ext 102
>>>>>
>>>>>
>>> --
>>> Ron Wheeler
>>> President
>>> Artifact Software Inc
>>> email: rwheeler@artifact-software.com
>>> skype: ronaldmwheeler
>>> phone: 866-970-2435, ext 102
>>>
>>>
>>
>> --
>> Daan
>>
>
>
--
Ron Wheeler
President
Artifact Software Inc
email: rwheeler@artifact-software.com
skype: ronaldmwheeler
phone: 866-970-2435, ext 102
Re: Git with Eclipse
Posted by Daan Hoogland <da...@gmail.com>.
never mind: https://github.com/apache/cloudstack-docs-admin/pull/31/files
looked in the wrong repo
On Tue, Nov 3, 2015 at 10:34 AM, Daan Hoogland <da...@gmail.com>
wrote:
> Ron, can you link us to your PR? there is 118 open at the moment and I
> don't see your name with the last bunch.
>
> On Mon, Nov 2, 2015 at 10:59 PM, Ron Wheeler <
> rwheeler@artifact-software.com> wrote:
>
>> Due to Sebastien and Daan's help, I have been able to create a pull
>> request for a small change to the docs.
>> https://wiki.eclipse.org/EGit/User_Guide#Working_with_remote_Repositories
>> was also a great help.
>> It took me a few attempts to get a push to my github repo working but it
>> finally worked.
>>
>> Eclipse/STS is pretty good for editing docs since it has an ReST editor
>> that provides an outline for documents.
>> I would like to have a Maven plug-in for Sphinx but I am not sure about
>> everyone else so it might be tricky to integrate it into my workflow
>> without affecting the master on git.
>>
>> If anyone has a chance to look at the pull request and let me know if I
>> got it right, that would be reassuring.
>>
>> Ron
>>
>>
>>
>>
>>
>> On 30/10/2015 5:58 AM, Sebastien Goasguen wrote:
>>
>>> Ron,
>>>
>>> I don’t know how to use Github with eclipse, I use the command line for
>>> everything.
>>>
>>> But the documentation should be good:
>>>
>>> https://github.com/apache/cloudstack-docs-admin#contributing-to-the-documentation
>>>
>>> Basically you need an account on GitHub.
>>> You fork https://github.com/apache/cloudstack-docs-admin (or the other
>>> docs repo).
>>> You will then have a fork at https://github.com/
>>> <YOUR_ACCOUNT>/cloudstack-docs-admin
>>>
>>> Clone your own fork:
>>>
>>> $ git clone https://github.com/<YOUR_ACCOUNT>/cloudstack-docs-admin
>>>
>>> Make your commits via eclipse and push to your own fork.
>>>
>>> Then on the GitHub UI, create a pull request to the upstream repo:
>>> https://github.com/apache/cloudstack-docs-admin
>>>
>>> -sebastien
>>>
>>> On Oct 29, 2015, at 9:58 PM, Ron Wheeler <rw...@artifact-software.com>
>>>> wrote:
>>>>
>>>> Trying to help out with the docs without doing too much damage.
>>>> I am new to git.
>>>>
>>>> I am using Eclipse with the egit/mylyn plug-in and I have managed to
>>>> get the source for the docs-admin downloaded.
>>>>
>>>> The "Configure Fetch" has a Source Ref of "refs/heads/*" and a
>>>> Desctination Ref of "refs/remotes/origin/*"
>>>> I think that I have the right sources. They seem to match the published
>>>> docs.
>>>>
>>>> I have made my changes and think that I need to create a pull request
>>>> to get one of the Cloudstack gods to decide if my attempts are worthy.
>>>>
>>>> I have created the pull request in Eclipse but when I try to submit it
>>>> I get an error box titled "Submit failed" popping up with the rather
>>>> cryptic "Unexpected error: Invalid request. "base", "head" weren't
>>>> supplied".
>>>> I think that I have to configure the "Remotes/origin/
>>>> https://gethub.com/apache/cloudstack-doc-admin.git" entry using
>>>> "Configure Push" menu.
>>>>
>>>> It has a section called "Ref mappings" that I gather is how git figures
>>>> out how I want my changes mapped back into the remote repos.
>>>>
>>>> Am I looking in the right places?
>>>> If so, what are the right "Source Ref" and "Destination Ref" entries to
>>>> get a pull request that will please the gods (both local and remote).
>>>>
>>>> It looks like editing and creating pull requests gets easy once this is
>>>> working.
>>>>
>>>> Still have to work on getting the document production working so I can
>>>> actually see the fruits of my labour.
>>>>
>>>> Thanks
>>>>
>>>> Ron
>>>>
>>>>
>>>> *
>>>> *
>>>>
>>>> --
>>>> Ron Wheeler
>>>> President
>>>> Artifact Software Inc
>>>> email: rwheeler@artifact-software.com
>>>> skype: ronaldmwheeler
>>>> phone: 866-970-2435, ext 102
>>>>
>>>>
>>>
>>
>> --
>> Ron Wheeler
>> President
>> Artifact Software Inc
>> email: rwheeler@artifact-software.com
>> skype: ronaldmwheeler
>> phone: 866-970-2435, ext 102
>>
>>
>
>
> --
> Daan
>
--
Daan
Re: Git with Eclipse
Posted by Daan Hoogland <da...@gmail.com>.
Ron, can you link us to your PR? there is 118 open at the moment and I
don't see your name with the last bunch.
On Mon, Nov 2, 2015 at 10:59 PM, Ron Wheeler <rwheeler@artifact-software.com
> wrote:
> Due to Sebastien and Daan's help, I have been able to create a pull
> request for a small change to the docs.
> https://wiki.eclipse.org/EGit/User_Guide#Working_with_remote_Repositories
> was also a great help.
> It took me a few attempts to get a push to my github repo working but it
> finally worked.
>
> Eclipse/STS is pretty good for editing docs since it has an ReST editor
> that provides an outline for documents.
> I would like to have a Maven plug-in for Sphinx but I am not sure about
> everyone else so it might be tricky to integrate it into my workflow
> without affecting the master on git.
>
> If anyone has a chance to look at the pull request and let me know if I
> got it right, that would be reassuring.
>
> Ron
>
>
>
>
>
> On 30/10/2015 5:58 AM, Sebastien Goasguen wrote:
>
>> Ron,
>>
>> I don’t know how to use Github with eclipse, I use the command line for
>> everything.
>>
>> But the documentation should be good:
>>
>> https://github.com/apache/cloudstack-docs-admin#contributing-to-the-documentation
>>
>> Basically you need an account on GitHub.
>> You fork https://github.com/apache/cloudstack-docs-admin (or the other
>> docs repo).
>> You will then have a fork at https://github.com/
>> <YOUR_ACCOUNT>/cloudstack-docs-admin
>>
>> Clone your own fork:
>>
>> $ git clone https://github.com/<YOUR_ACCOUNT>/cloudstack-docs-admin
>>
>> Make your commits via eclipse and push to your own fork.
>>
>> Then on the GitHub UI, create a pull request to the upstream repo:
>> https://github.com/apache/cloudstack-docs-admin
>>
>> -sebastien
>>
>> On Oct 29, 2015, at 9:58 PM, Ron Wheeler <rw...@artifact-software.com>
>>> wrote:
>>>
>>> Trying to help out with the docs without doing too much damage.
>>> I am new to git.
>>>
>>> I am using Eclipse with the egit/mylyn plug-in and I have managed to get
>>> the source for the docs-admin downloaded.
>>>
>>> The "Configure Fetch" has a Source Ref of "refs/heads/*" and a
>>> Desctination Ref of "refs/remotes/origin/*"
>>> I think that I have the right sources. They seem to match the published
>>> docs.
>>>
>>> I have made my changes and think that I need to create a pull request to
>>> get one of the Cloudstack gods to decide if my attempts are worthy.
>>>
>>> I have created the pull request in Eclipse but when I try to submit it I
>>> get an error box titled "Submit failed" popping up with the rather cryptic
>>> "Unexpected error: Invalid request. "base", "head" weren't supplied".
>>> I think that I have to configure the "Remotes/origin/
>>> https://gethub.com/apache/cloudstack-doc-admin.git" entry using
>>> "Configure Push" menu.
>>>
>>> It has a section called "Ref mappings" that I gather is how git figures
>>> out how I want my changes mapped back into the remote repos.
>>>
>>> Am I looking in the right places?
>>> If so, what are the right "Source Ref" and "Destination Ref" entries to
>>> get a pull request that will please the gods (both local and remote).
>>>
>>> It looks like editing and creating pull requests gets easy once this is
>>> working.
>>>
>>> Still have to work on getting the document production working so I can
>>> actually see the fruits of my labour.
>>>
>>> Thanks
>>>
>>> Ron
>>>
>>>
>>> *
>>> *
>>>
>>> --
>>> Ron Wheeler
>>> President
>>> Artifact Software Inc
>>> email: rwheeler@artifact-software.com
>>> skype: ronaldmwheeler
>>> phone: 866-970-2435, ext 102
>>>
>>>
>>
>
> --
> Ron Wheeler
> President
> Artifact Software Inc
> email: rwheeler@artifact-software.com
> skype: ronaldmwheeler
> phone: 866-970-2435, ext 102
>
>
--
Daan