New Documentation Site
76 views
Skip to first unread message
Lee Hambley
Aug 11, 2012, 9:49:08 AM8/11/12
to capistrano
Hi All,
I've moved the documentation (formerly "Wiki -> Documentation v2.x") to a Github Pages site hosted in a `gh-pages` branch of the main repository.
The domain capify.org redirects to capistranorb.com, which is registered via the Github CNAME (nice feature for gh-pages) file for the gh-pages branch.
The wiki page might still be there, it can probably be removed, and time will tell - someone will delete it; they always do.
Pull requests for documentation are more than welcome, but we had to tighten controls a little, as the wiki page was disappearing once a week, with people often helpfuly reorganising, without realising that we relied on that page for our two main domains.
Footnote, the domain "Capistranorb.com" is the one I would prefer to use going forward, on the wave of ".js" and ".rb" named projects, and to further distance Capistrano(.rb) from it's namesake city in California.
The site is the result of an hours work on my vacation time, please feel free to pull request improvements.
- Lee
Donovan Bray
Aug 11, 2012, 12:16:46 PM8/11/12
to capis...@googlegroups.com
Thanks Lee, I appreciate your excellent stewardship of Capistrano, and I think the new name will help folks find the docs with less noise.
I'm in the habit of always pre pending 'ruby' to my google queries for ruby based queries.
Google, 'god' vs 'ruby god' as an example. Talk about noise....
--
* You received this message because you are subscribed to the Google Groups "Capistrano" group.
* To post to this group, send email to capis...@googlegroups.com
* To unsubscribe from this group, send email to capistrano+...@googlegroups.com For more options, visit this group at http://groups.google.com/group/capistrano?hl=en
Lee Hambley
Aug 11, 2012, 12:27:34 PM8/11/12
to capis...@googlegroups.com
Absolutely Donovan!
And thanks for the kind words, I worry that I am a constant disappointment to the community, I wish I could devote myself full time to Cap.
- Lee
Jonathan Rochkind
Aug 20, 2012, 10:05:03 AM8/20/12
to capis...@googlegroups.com
Suggest you mention prominently on the main documentation page how you
find the branch in the repo to make pull requests.
This extra barrier will definitely reduce the amount of people who end
up taking/having the time to take/add documentation, but I guess
everything's a tradeoff.
On 8/11/2012 9:49 AM, Lee Hambley wrote:
> Hi All,
>
> I've moved the documentation (formerly "Wiki -> Documentation v2.x") to
> a Github Pages site hosted in a `gh-pages` branch of the main repository.
>
> The domain capify.org <http://capify.org> redirects to capistranorb.com
> <http://capistranorb.com>, which is registered via the Github CNAME
find the branch in the repo to make pull requests.
This extra barrier will definitely reduce the amount of people who end
up taking/having the time to take/add documentation, but I guess
everything's a tradeoff.
On 8/11/2012 9:49 AM, Lee Hambley wrote:
> Hi All,
>
> I've moved the documentation (formerly "Wiki -> Documentation v2.x") to
> a Github Pages site hosted in a `gh-pages` branch of the main repository.
>
> <http://capistranorb.com>, which is registered via the Github CNAME
> (nice feature for gh-pages) file for the gh-pages branch.
>
> The wiki page might still be there, it can probably be removed, and time
> will tell - someone will delete it; they always do.
>
> Pull requests for documentation are more than welcome, but we had to
> tighten controls a little, as the wiki page was disappearing once a
> week, with people often helpfuly reorganising, without realising that we
> relied on that page for our two main domains.
>
> Footnote, the domain "Capistranorb.com" is the one I would prefer to use
> going forward, on the wave of ".js" and ".rb" named projects, and to
> further distance Capistrano(.rb) from it's namesake city in California.
>
> The site is the result of an hours work on my vacation time, please feel
> free to pull request improvements.
>
> - Lee
>
>
> The wiki page might still be there, it can probably be removed, and time
> will tell - someone will delete it; they always do.
>
> Pull requests for documentation are more than welcome, but we had to
> tighten controls a little, as the wiki page was disappearing once a
> week, with people often helpfuly reorganising, without realising that we
> relied on that page for our two main domains.
>
> Footnote, the domain "Capistranorb.com" is the one I would prefer to use
> going forward, on the wave of ".js" and ".rb" named projects, and to
> further distance Capistrano(.rb) from it's namesake city in California.
>
> The site is the result of an hours work on my vacation time, please feel
> free to pull request improvements.
>
> - Lee
>
Lee Hambley
Aug 20, 2012, 11:10:17 AM8/20/12
to capis...@googlegroups.com
Jonathan,
Fair point, I actually burned all the free time I have in the next few weeks on squashing that issue. You are absolutely right about that, I hope the wiki will become deeper, rather than wider, and that people will continue to contribute to the wiki.
- Lee
Jonathan Rochkind
Aug 20, 2012, 11:27:50 AM8/20/12
to capis...@googlegroups.com, Lee Hambley
Ah, right, the wiki is still there too -- makes sense.
On 8/20/2012 11:10 AM, Lee Hambley wrote:
> Jonathan,
>
> Fair point, I actually burned all the free time I have in the next few
> weeks on squashing that issue. You are absolutely right about that, I
> hope the wiki will become deeper, rather than wider, and that people
> will continue to contribute to the wiki.
>
> - Lee
>
> --
> Lee Hambley
> Sent with Sparrow <http://www.sparrowmailapp.com/?sig>
>>> <mailto:capistrano+...@googlegroups.com> For more options,
On 8/20/2012 11:10 AM, Lee Hambley wrote:
> Jonathan,
>
> Fair point, I actually burned all the free time I have in the next few
> weeks on squashing that issue. You are absolutely right about that, I
> hope the wiki will become deeper, rather than wider, and that people
> will continue to contribute to the wiki.
>
> - Lee
>
> --
> Lee Hambley
>
> On Monday, August 20, 2012 at 4:05 PM, Jonathan Rochkind wrote:
>
>> Suggest you mention prominently on the main documentation page how you
>> find the branch in the repo to make pull requests.
>>
>> This extra barrier will definitely reduce the amount of people who end
>> up taking/having the time to take/add documentation, but I guess
>> everything's a tradeoff.
>>
>> On 8/11/2012 9:49 AM, Lee Hambley wrote:
>>> Hi All,
>>>
>>> I've moved the documentation (formerly "Wiki -> Documentation v2.x") to
>>> a Github Pages site hosted in a `gh-pages` branch of the main repository.
>>>
>>> The domain capify.org <http://capify.org> redirects to
>>> capistranorb.com <http://capistranorb.com>
>>> <http://capistranorb.com>, which is registered via the Github CNAME
>>> (nice feature for gh-pages) file for the gh-pages branch.
>>>
>>> The wiki page might still be there, it can probably be removed, and time
>>> will tell - someone will delete it; they always do.
>>>
>>> Pull requests for documentation are more than welcome, but we had to
>>> tighten controls a little, as the wiki page was disappearing once a
>>> week, with people often helpfuly reorganising, without realising that we
>>> relied on that page for our two main domains.
>>>
>>> Footnote, the domain "Capistranorb.com <http://Capistranorb.com>" is
> On Monday, August 20, 2012 at 4:05 PM, Jonathan Rochkind wrote:
>
>> Suggest you mention prominently on the main documentation page how you
>> find the branch in the repo to make pull requests.
>>
>> This extra barrier will definitely reduce the amount of people who end
>> up taking/having the time to take/add documentation, but I guess
>> everything's a tradeoff.
>>
>> On 8/11/2012 9:49 AM, Lee Hambley wrote:
>>> Hi All,
>>>
>>> I've moved the documentation (formerly "Wiki -> Documentation v2.x") to
>>> a Github Pages site hosted in a `gh-pages` branch of the main repository.
>>>
>>> The domain capify.org <http://capify.org> redirects to
>>> capistranorb.com <http://capistranorb.com>
>>> <http://capistranorb.com>, which is registered via the Github CNAME
>>> (nice feature for gh-pages) file for the gh-pages branch.
>>>
>>> The wiki page might still be there, it can probably be removed, and time
>>> will tell - someone will delete it; they always do.
>>>
>>> Pull requests for documentation are more than welcome, but we had to
>>> tighten controls a little, as the wiki page was disappearing once a
>>> week, with people often helpfuly reorganising, without realising that we
>>> relied on that page for our two main domains.
>>>
>>> the one I would prefer to use
>>> going forward, on the wave of ".js" and ".rb" named projects, and to
>>> further distance Capistrano(.rb) from it's namesake city in California.
>>>
>>> The site is the result of an hours work on my vacation time, please feel
>>> free to pull request improvements.
>>>
>>> - Lee
>>>
>>> --
>>> * You received this message because you are subscribed to the Google
>>> Groups "Capistrano" group.
>>> * To post to this group, send email to capis...@googlegroups.com
>>> <mailto:capis...@googlegroups.com>
>>> going forward, on the wave of ".js" and ".rb" named projects, and to
>>> further distance Capistrano(.rb) from it's namesake city in California.
>>>
>>> The site is the result of an hours work on my vacation time, please feel
>>> free to pull request improvements.
>>>
>>> - Lee
>>>
>>> --
>>> * You received this message because you are subscribed to the Google
>>> Groups "Capistrano" group.
>>> * To post to this group, send email to capis...@googlegroups.com
>>> <mailto:capistrano+...@googlegroups.com> For more options,
>>> visit this
>>> group at http://groups.google.com/group/capistrano?hl=en
>>
>> --
>> * You received this message because you are subscribed to the Google
>> Groups "Capistrano" group.
>> * To post to this group, send email to capis...@googlegroups.com
>> <mailto:capis...@googlegroups.com>
>>> group at http://groups.google.com/group/capistrano?hl=en
>>
>> --
>> * You received this message because you are subscribed to the Google
>> Groups "Capistrano" group.
>> * To post to this group, send email to capis...@googlegroups.com
Reply all
Reply to author
Forward
Message has been deleted
0 new messages