You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@cordova.apache.org by Carlos Santana <cs...@gmail.com> on 2016/03/08 17:50:16 UTC
Edit to Edit on Github for Docs
The other day I was looking like crazy the doc source code that
corresponded to the page that a user was asking here in dev list where was
the source code, so I assume he also didn't see the "Edit"
Then someone pointed out there is an "Edit" link/button at the top right
side of each page.
Then I saw another website, can't remember now, but they had "Edit on
Github" and having the "on Github" capture my attention.
What you guys think about change it from "Edit" to "Edit on Github" is that
a good change or it's just me
RE: Edit to Edit on Github for Docs
Posted by Dmitry Blotsky <db...@microsoft.com>.
Here is an alternative implementation: https://github.com/apache/cordova-docs/pull/555.
Kindly,
Dmitry
-----Original Message-----
From: Dmitry Blotsky [mailto:dblotsky@microsoft.com]
Sent: Friday, March 11, 2016 4:25 PM
To: dev@cordova.apache.org
Subject: RE: Edit to Edit on Github for Docs
Once JIRA comes back up, please feel free to create a task for adding the "Edit" button to non-docs pages.
As for the wording, I went for "Edit" on the dropdown because there are two different things to edit: translation and content. The link to edit content says that it's on GitHub, and the translation link says that it's on Crowdin. Do you guys think just "Edit" is ok on the dropdown? It's not too intimidating, and when you click on it the editing options are very self-explanatory.
Kindly,
Dmitry
-----Original Message-----
From: Carlos Santana [mailto:csantana23@gmail.com]
Sent: Thursday, March 10, 2016 3:46 PM
To: dev@cordova.apache.org
Subject: Re: Edit to Edit on Github for Docs
I agree Robert
This points out that [1] Contribute page is missing the Edit button :-). If it was there you could've submitted the change
Add to the list another way to help the project by clicking that Edit link and help out
Advertise the "Edit Source on Github" link with some info how easy and how the changes will eventually make it in
[1] https://na01.safelinks.protection.outlook.com/?url=http%3a%2f%2fcordova.apache.org%2fcontribute%2f&data=01%7c01%7cdblotsky%40microsoft.com%7ca7ce110509254069a29408d3493e29be%7c72f988bf86f141af91ab2d7cd011db47%7c1&sdata=Ujf0vgImhLX4HLy5xdXgdHrQNNCUiTCsY0Ps8Iqbgqc%3d
- Carlos
@csantanapr
> On Mar 10, 2016, at 5:50 PM, Robert Posener <rp...@gmail.com> wrote:
>
> In my confused mode (as documented in my last e-mail) when I was
> wondering what does this "Edit" button do? I went looking for an
> answer on different Cordova documentation and contributor web pages.
> No answer was found. I would have thought it should be explained
> under "Contributing" somewhere and saying that you don't need to be a
> committer or have a login and that you can't stuff anything up and
> whatever you contribute will be reviewed by a knowledgeable person before it is committed.
>
> Rob
>
> Regards
> *Rob Posener*
> 0419 012 627
>
>> On 10 March 2016 at 23:47, Dmitry Blotsky <db...@microsoft.com> wrote:
>>
>> Hey Robert,
>>
>> What do you mean by the “Edit” button being documented?
>>
>> Also folks: here is a PR with a change addressing this discussion and
>> a bit more: https://github.com/apache/cordova-docs/pull/551/files.
>>
>> Kindly,
>> Dmitry
>>
>> On Mar 9, 2016, at 2:19 PM, Robert Posener <rposener8@gmail.com<mailto:
>> rposener8@gmail.com>> wrote:
>>
>> Also, can we add "Edit on GitHub" to Blog and Plugin pages, please.
>>
>> Regards
>> *Rob Posener*
>> 0419 012 627
>>
>> On 10 March 2016 at 09:14, Robert Posener <rposener8@gmail.com<mailto:
>> rposener8@gmail.com>> wrote:
>>
>> I like "Edit on GitHub".
>>
>> I was never sure how far into "editing" clicking on the "Edit" button
>> would take me before I hit some roadblock (like needing to be a
>> committer, like having a GitHub login, like being part of the cordova
>> in-crowd, etc) that meant that I had wasted my time. It would be
>> nice to clarify this (eg, a hover tip like "No login necessary - Will
>> be queued for review by committers").
>> Also... where is the "Edit" button documented?
>>
>> Rob
>>
>> Regards
>> *Rob Posener*
>> 0419 012 627
>>
>> On 9 March 2016 at 10:29, Dmitry Blotsky <dblotsky@microsoft.com<mailto:
>> dblotsky@microsoft.com>> wrote:
>>
>> I don't know if we have A/B testing capabilities, but I'm cool with
>> changing the text to "Edit on GitHub". Also, we have like 10 open PRs
>> for docs from contributors, so the buttons definitely work. :)
>>
>> I'll make the change for "Edit on GitHub" unless someone objects.
>>
>> Kindly,
>> Dmitry
>>
>> -----Original Message-----
>> From: Jesse [mailto:purplecabbage@gmail.com]
>> Sent: Tuesday, March 8, 2016 11:26 AM
>> To: dev@cordova.apache.org<ma...@cordova.apache.org>
>> Subject: Re: Edit to Edit on Github for Docs
>>
>> +1 to AB testing!
>>
>>
>> On Mar 8, 2016, at 11:02 AM, Steven Gill <stevengill97@gmail.com<mailto:
>> stevengill97@gmail.com>>
>> wrote:
>>
>> Look at us talking UX. Lets do some AB testing while we are at ;)
>>
>> On Tue, Mar 8, 2016 at 10:54 AM, Nikhil Khandelwal
>> <ni...@microsoft.com>>
>> wrote:
>>
>> +1 for trying "Edit on Github" - anything that _may_ increase
>> contributions to the docs is welcome. :)
>>
>> -Nikhil
>>
>> -----Original Message-----
>> From: Shazron [mailto:shazron@gmail.com]
>> Sent: Tuesday, March 8, 2016 10:26 AM
>> To: dev@cordova.apache.org<ma...@cordova.apache.org>
>> Subject: Re: Edit to Edit on Github for Docs
>>
>> I'm ambivalent. "Edit" is concise, and I would think most are curious
>> enough to just click and see?
>>
>> On Tue, Mar 8, 2016 at 8:50 AM, Carlos Santana <csantana23@gmail.com
>> <ma...@gmail.com>>
>> wrote:
>> The other day I was looking like crazy the doc source code that
>> corresponded to the page that a user was asking here in dev list
>> where was the source code, so I assume he also didn't see the "Edit"
>>
>> Then someone pointed out there is an "Edit" link/button at the top
>> right side of each page.
>>
>> Then I saw another website, can't remember now, but they had "Edit on
>> Github" and having the "on Github" capture my attention.
>>
>> What you guys think about change it from "Edit" to "Edit on Github"
>> is that a good change or it's just me
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org<mailto:
>> dev-unsubscribe@cordova.apache.org>
>> For additional commands, e-mail: dev-help@cordova.apache.org<mailto:
>> dev-help@cordova.apache.org>
>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org<mailto:
>> dev-unsubscribe@cordova.apache.org>
>> For additional commands, e-mail: dev-help@cordova.apache.org<mailto:
>> dev-help@cordova.apache.org>
>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org<mailto:
>> dev-unsubscribe@cordova.apache.org>
>> For additional commands, e-mail: dev-help@cordova.apache.org<mailto:
>> dev-help@cordova.apache.org>
>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org<mailto:
>> dev-unsubscribe@cordova.apache.org>
>> For additional commands, e-mail: dev-help@cordova.apache.org<mailto:
>> dev-help@cordova.apache.org>
>>
>>
>>
>>
>>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org
For additional commands, e-mail: dev-help@cordova.apache.org
RE: Edit to Edit on Github for Docs
Posted by Dmitry Blotsky <db...@microsoft.com>.
Once JIRA comes back up, please feel free to create a task for adding the "Edit" button to non-docs pages.
As for the wording, I went for "Edit" on the dropdown because there are two different things to edit: translation and content. The link to edit content says that it's on GitHub, and the translation link says that it's on Crowdin. Do you guys think just "Edit" is ok on the dropdown? It's not too intimidating, and when you click on it the editing options are very self-explanatory.
Kindly,
Dmitry
-----Original Message-----
From: Carlos Santana [mailto:csantana23@gmail.com]
Sent: Thursday, March 10, 2016 3:46 PM
To: dev@cordova.apache.org
Subject: Re: Edit to Edit on Github for Docs
I agree Robert
This points out that [1] Contribute page is missing the Edit button :-). If it was there you could've submitted the change
Add to the list another way to help the project by clicking that Edit link and help out
Advertise the "Edit Source on Github" link with some info how easy and how the changes will eventually make it in
[1] https://na01.safelinks.protection.outlook.com/?url=http%3a%2f%2fcordova.apache.org%2fcontribute%2f&data=01%7c01%7cdblotsky%40microsoft.com%7ca7ce110509254069a29408d3493e29be%7c72f988bf86f141af91ab2d7cd011db47%7c1&sdata=Ujf0vgImhLX4HLy5xdXgdHrQNNCUiTCsY0Ps8Iqbgqc%3d
- Carlos
@csantanapr
> On Mar 10, 2016, at 5:50 PM, Robert Posener <rp...@gmail.com> wrote:
>
> In my confused mode (as documented in my last e-mail) when I was
> wondering what does this "Edit" button do? I went looking for an
> answer on different Cordova documentation and contributor web pages.
> No answer was found. I would have thought it should be explained
> under "Contributing" somewhere and saying that you don't need to be a
> committer or have a login and that you can't stuff anything up and
> whatever you contribute will be reviewed by a knowledgeable person before it is committed.
>
> Rob
>
> Regards
> *Rob Posener*
> 0419 012 627
>
>> On 10 March 2016 at 23:47, Dmitry Blotsky <db...@microsoft.com> wrote:
>>
>> Hey Robert,
>>
>> What do you mean by the “Edit” button being documented?
>>
>> Also folks: here is a PR with a change addressing this discussion and
>> a bit more: https://github.com/apache/cordova-docs/pull/551/files.
>>
>> Kindly,
>> Dmitry
>>
>> On Mar 9, 2016, at 2:19 PM, Robert Posener <rposener8@gmail.com<mailto:
>> rposener8@gmail.com>> wrote:
>>
>> Also, can we add "Edit on GitHub" to Blog and Plugin pages, please.
>>
>> Regards
>> *Rob Posener*
>> 0419 012 627
>>
>> On 10 March 2016 at 09:14, Robert Posener <rposener8@gmail.com<mailto:
>> rposener8@gmail.com>> wrote:
>>
>> I like "Edit on GitHub".
>>
>> I was never sure how far into "editing" clicking on the "Edit" button
>> would take me before I hit some roadblock (like needing to be a
>> committer, like having a GitHub login, like being part of the cordova
>> in-crowd, etc) that meant that I had wasted my time. It would be
>> nice to clarify this (eg, a hover tip like "No login necessary - Will
>> be queued for review by committers").
>> Also... where is the "Edit" button documented?
>>
>> Rob
>>
>> Regards
>> *Rob Posener*
>> 0419 012 627
>>
>> On 9 March 2016 at 10:29, Dmitry Blotsky <dblotsky@microsoft.com<mailto:
>> dblotsky@microsoft.com>> wrote:
>>
>> I don't know if we have A/B testing capabilities, but I'm cool with
>> changing the text to "Edit on GitHub". Also, we have like 10 open PRs
>> for docs from contributors, so the buttons definitely work. :)
>>
>> I'll make the change for "Edit on GitHub" unless someone objects.
>>
>> Kindly,
>> Dmitry
>>
>> -----Original Message-----
>> From: Jesse [mailto:purplecabbage@gmail.com]
>> Sent: Tuesday, March 8, 2016 11:26 AM
>> To: dev@cordova.apache.org<ma...@cordova.apache.org>
>> Subject: Re: Edit to Edit on Github for Docs
>>
>> +1 to AB testing!
>>
>>
>> On Mar 8, 2016, at 11:02 AM, Steven Gill <stevengill97@gmail.com<mailto:
>> stevengill97@gmail.com>>
>> wrote:
>>
>> Look at us talking UX. Lets do some AB testing while we are at ;)
>>
>> On Tue, Mar 8, 2016 at 10:54 AM, Nikhil Khandelwal
>> <ni...@microsoft.com>>
>> wrote:
>>
>> +1 for trying "Edit on Github" - anything that _may_ increase
>> contributions to the docs is welcome. :)
>>
>> -Nikhil
>>
>> -----Original Message-----
>> From: Shazron [mailto:shazron@gmail.com]
>> Sent: Tuesday, March 8, 2016 10:26 AM
>> To: dev@cordova.apache.org<ma...@cordova.apache.org>
>> Subject: Re: Edit to Edit on Github for Docs
>>
>> I'm ambivalent. "Edit" is concise, and I would think most are curious
>> enough to just click and see?
>>
>> On Tue, Mar 8, 2016 at 8:50 AM, Carlos Santana <csantana23@gmail.com
>> <ma...@gmail.com>>
>> wrote:
>> The other day I was looking like crazy the doc source code that
>> corresponded to the page that a user was asking here in dev list
>> where was the source code, so I assume he also didn't see the "Edit"
>>
>> Then someone pointed out there is an "Edit" link/button at the top
>> right side of each page.
>>
>> Then I saw another website, can't remember now, but they had "Edit on
>> Github" and having the "on Github" capture my attention.
>>
>> What you guys think about change it from "Edit" to "Edit on Github"
>> is that a good change or it's just me
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org<mailto:
>> dev-unsubscribe@cordova.apache.org>
>> For additional commands, e-mail: dev-help@cordova.apache.org<mailto:
>> dev-help@cordova.apache.org>
>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org<mailto:
>> dev-unsubscribe@cordova.apache.org>
>> For additional commands, e-mail: dev-help@cordova.apache.org<mailto:
>> dev-help@cordova.apache.org>
>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org<mailto:
>> dev-unsubscribe@cordova.apache.org>
>> For additional commands, e-mail: dev-help@cordova.apache.org<mailto:
>> dev-help@cordova.apache.org>
>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org<mailto:
>> dev-unsubscribe@cordova.apache.org>
>> For additional commands, e-mail: dev-help@cordova.apache.org<mailto:
>> dev-help@cordova.apache.org>
>>
>>
>>
>>
>>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org
For additional commands, e-mail: dev-help@cordova.apache.org
Re: Edit to Edit on Github for Docs
Posted by Carlos Santana <cs...@gmail.com>.
I agree Robert
This points out that [1] Contribute page is missing the Edit button :-). If it was there you could've submitted the change
Add to the list another way to help the project by clicking that Edit link and help out
Advertise the "Edit Source on Github" link with some info how easy and how the changes will eventually make it in
[1] http://cordova.apache.org/contribute/
- Carlos
@csantanapr
> On Mar 10, 2016, at 5:50 PM, Robert Posener <rp...@gmail.com> wrote:
>
> In my confused mode (as documented in my last e-mail) when I was wondering
> what does this "Edit" button do? I went looking for an answer on different
> Cordova documentation and contributor web pages. No answer was found. I
> would have thought it should be explained under "Contributing" somewhere
> and saying that you don't need to be a committer or have a login and that
> you can't stuff anything up and whatever you contribute will be reviewed by
> a knowledgeable person before it is committed.
>
> Rob
>
> Regards
> *Rob Posener*
> 0419 012 627
>
>> On 10 March 2016 at 23:47, Dmitry Blotsky <db...@microsoft.com> wrote:
>>
>> Hey Robert,
>>
>> What do you mean by the “Edit” button being documented?
>>
>> Also folks: here is a PR with a change addressing this discussion and a
>> bit more: https://github.com/apache/cordova-docs/pull/551/files.
>>
>> Kindly,
>> Dmitry
>>
>> On Mar 9, 2016, at 2:19 PM, Robert Posener <rposener8@gmail.com<mailto:
>> rposener8@gmail.com>> wrote:
>>
>> Also, can we add "Edit on GitHub" to Blog and Plugin pages, please.
>>
>> Regards
>> *Rob Posener*
>> 0419 012 627
>>
>> On 10 March 2016 at 09:14, Robert Posener <rposener8@gmail.com<mailto:
>> rposener8@gmail.com>> wrote:
>>
>> I like "Edit on GitHub".
>>
>> I was never sure how far into "editing" clicking on the "Edit" button
>> would take me before I hit some roadblock (like needing to be a committer,
>> like having a GitHub login, like being part of the cordova in-crowd, etc)
>> that meant that I had wasted my time. It would be nice to clarify this
>> (eg, a hover tip like "No login necessary - Will be queued for review by
>> committers").
>> Also... where is the "Edit" button documented?
>>
>> Rob
>>
>> Regards
>> *Rob Posener*
>> 0419 012 627
>>
>> On 9 March 2016 at 10:29, Dmitry Blotsky <dblotsky@microsoft.com<mailto:
>> dblotsky@microsoft.com>> wrote:
>>
>> I don't know if we have A/B testing capabilities, but I'm cool with
>> changing the text to "Edit on GitHub". Also, we have like 10 open PRs for
>> docs from contributors, so the buttons definitely work. :)
>>
>> I'll make the change for "Edit on GitHub" unless someone objects.
>>
>> Kindly,
>> Dmitry
>>
>> -----Original Message-----
>> From: Jesse [mailto:purplecabbage@gmail.com]
>> Sent: Tuesday, March 8, 2016 11:26 AM
>> To: dev@cordova.apache.org<ma...@cordova.apache.org>
>> Subject: Re: Edit to Edit on Github for Docs
>>
>> +1 to AB testing!
>>
>>
>> On Mar 8, 2016, at 11:02 AM, Steven Gill <stevengill97@gmail.com<mailto:
>> stevengill97@gmail.com>>
>> wrote:
>>
>> Look at us talking UX. Lets do some AB testing while we are at ;)
>>
>> On Tue, Mar 8, 2016 at 10:54 AM, Nikhil Khandelwal
>> <ni...@microsoft.com>>
>> wrote:
>>
>> +1 for trying "Edit on Github" - anything that _may_ increase
>> contributions to the docs is welcome. :)
>>
>> -Nikhil
>>
>> -----Original Message-----
>> From: Shazron [mailto:shazron@gmail.com]
>> Sent: Tuesday, March 8, 2016 10:26 AM
>> To: dev@cordova.apache.org<ma...@cordova.apache.org>
>> Subject: Re: Edit to Edit on Github for Docs
>>
>> I'm ambivalent. "Edit" is concise, and I would think most are curious
>> enough to just click and see?
>>
>> On Tue, Mar 8, 2016 at 8:50 AM, Carlos Santana <csantana23@gmail.com
>> <ma...@gmail.com>>
>> wrote:
>> The other day I was looking like crazy the doc source code that
>> corresponded to the page that a user was asking here in dev list
>> where was the source code, so I assume he also didn't see the "Edit"
>>
>> Then someone pointed out there is an "Edit" link/button at the top
>> right side of each page.
>>
>> Then I saw another website, can't remember now, but they had "Edit
>> on Github" and having the "on Github" capture my attention.
>>
>> What you guys think about change it from "Edit" to "Edit on Github"
>> is that a good change or it's just me
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org<mailto:
>> dev-unsubscribe@cordova.apache.org>
>> For additional commands, e-mail: dev-help@cordova.apache.org<mailto:
>> dev-help@cordova.apache.org>
>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org<mailto:
>> dev-unsubscribe@cordova.apache.org>
>> For additional commands, e-mail: dev-help@cordova.apache.org<mailto:
>> dev-help@cordova.apache.org>
>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org<mailto:
>> dev-unsubscribe@cordova.apache.org>
>> For additional commands, e-mail: dev-help@cordova.apache.org<mailto:
>> dev-help@cordova.apache.org>
>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org<mailto:
>> dev-unsubscribe@cordova.apache.org>
>> For additional commands, e-mail: dev-help@cordova.apache.org<mailto:
>> dev-help@cordova.apache.org>
>>
>>
>>
>>
>>
Re: Edit to Edit on Github for Docs
Posted by Robert Posener <rp...@gmail.com>.
In my confused mode (as documented in my last e-mail) when I was wondering
what does this "Edit" button do? I went looking for an answer on different
Cordova documentation and contributor web pages. No answer was found. I
would have thought it should be explained under "Contributing" somewhere
and saying that you don't need to be a committer or have a login and that
you can't stuff anything up and whatever you contribute will be reviewed by
a knowledgeable person before it is committed.
Rob
Regards
*Rob Posener*
0419 012 627
On 10 March 2016 at 23:47, Dmitry Blotsky <db...@microsoft.com> wrote:
> Hey Robert,
>
> What do you mean by the “Edit” button being documented?
>
> Also folks: here is a PR with a change addressing this discussion and a
> bit more: https://github.com/apache/cordova-docs/pull/551/files.
>
> Kindly,
> Dmitry
>
> On Mar 9, 2016, at 2:19 PM, Robert Posener <rposener8@gmail.com<mailto:
> rposener8@gmail.com>> wrote:
>
> Also, can we add "Edit on GitHub" to Blog and Plugin pages, please.
>
> Regards
> *Rob Posener*
> 0419 012 627
>
> On 10 March 2016 at 09:14, Robert Posener <rposener8@gmail.com<mailto:
> rposener8@gmail.com>> wrote:
>
> I like "Edit on GitHub".
>
> I was never sure how far into "editing" clicking on the "Edit" button
> would take me before I hit some roadblock (like needing to be a committer,
> like having a GitHub login, like being part of the cordova in-crowd, etc)
> that meant that I had wasted my time. It would be nice to clarify this
> (eg, a hover tip like "No login necessary - Will be queued for review by
> committers").
> Also... where is the "Edit" button documented?
>
> Rob
>
> Regards
> *Rob Posener*
> 0419 012 627
>
> On 9 March 2016 at 10:29, Dmitry Blotsky <dblotsky@microsoft.com<mailto:
> dblotsky@microsoft.com>> wrote:
>
> I don't know if we have A/B testing capabilities, but I'm cool with
> changing the text to "Edit on GitHub". Also, we have like 10 open PRs for
> docs from contributors, so the buttons definitely work. :)
>
> I'll make the change for "Edit on GitHub" unless someone objects.
>
> Kindly,
> Dmitry
>
> -----Original Message-----
> From: Jesse [mailto:purplecabbage@gmail.com]
> Sent: Tuesday, March 8, 2016 11:26 AM
> To: dev@cordova.apache.org<ma...@cordova.apache.org>
> Subject: Re: Edit to Edit on Github for Docs
>
> +1 to AB testing!
>
>
> On Mar 8, 2016, at 11:02 AM, Steven Gill <stevengill97@gmail.com<mailto:
> stevengill97@gmail.com>>
> wrote:
>
> Look at us talking UX. Lets do some AB testing while we are at ;)
>
> On Tue, Mar 8, 2016 at 10:54 AM, Nikhil Khandelwal
> <ni...@microsoft.com>>
> wrote:
>
> +1 for trying "Edit on Github" - anything that _may_ increase
> contributions to the docs is welcome. :)
>
> -Nikhil
>
> -----Original Message-----
> From: Shazron [mailto:shazron@gmail.com]
> Sent: Tuesday, March 8, 2016 10:26 AM
> To: dev@cordova.apache.org<ma...@cordova.apache.org>
> Subject: Re: Edit to Edit on Github for Docs
>
> I'm ambivalent. "Edit" is concise, and I would think most are curious
> enough to just click and see?
>
> On Tue, Mar 8, 2016 at 8:50 AM, Carlos Santana <csantana23@gmail.com
> <ma...@gmail.com>>
> wrote:
> The other day I was looking like crazy the doc source code that
> corresponded to the page that a user was asking here in dev list
> where was the source code, so I assume he also didn't see the "Edit"
>
> Then someone pointed out there is an "Edit" link/button at the top
> right side of each page.
>
> Then I saw another website, can't remember now, but they had "Edit
> on Github" and having the "on Github" capture my attention.
>
> What you guys think about change it from "Edit" to "Edit on Github"
> is that a good change or it's just me
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org<mailto:
> dev-unsubscribe@cordova.apache.org>
> For additional commands, e-mail: dev-help@cordova.apache.org<mailto:
> dev-help@cordova.apache.org>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org<mailto:
> dev-unsubscribe@cordova.apache.org>
> For additional commands, e-mail: dev-help@cordova.apache.org<mailto:
> dev-help@cordova.apache.org>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org<mailto:
> dev-unsubscribe@cordova.apache.org>
> For additional commands, e-mail: dev-help@cordova.apache.org<mailto:
> dev-help@cordova.apache.org>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org<mailto:
> dev-unsubscribe@cordova.apache.org>
> For additional commands, e-mail: dev-help@cordova.apache.org<mailto:
> dev-help@cordova.apache.org>
>
>
>
>
>
Re: Edit to Edit on Github for Docs
Posted by Dmitry Blotsky <db...@microsoft.com>.
Hey Robert,
What do you mean by the “Edit” button being documented?
Also folks: here is a PR with a change addressing this discussion and a bit more: https://github.com/apache/cordova-docs/pull/551/files.
Kindly,
Dmitry
On Mar 9, 2016, at 2:19 PM, Robert Posener <rp...@gmail.com>> wrote:
Also, can we add "Edit on GitHub" to Blog and Plugin pages, please.
Regards
*Rob Posener*
0419 012 627
On 10 March 2016 at 09:14, Robert Posener <rp...@gmail.com>> wrote:
I like "Edit on GitHub".
I was never sure how far into "editing" clicking on the "Edit" button
would take me before I hit some roadblock (like needing to be a committer,
like having a GitHub login, like being part of the cordova in-crowd, etc)
that meant that I had wasted my time. It would be nice to clarify this
(eg, a hover tip like "No login necessary - Will be queued for review by
committers").
Also... where is the "Edit" button documented?
Rob
Regards
*Rob Posener*
0419 012 627
On 9 March 2016 at 10:29, Dmitry Blotsky <db...@microsoft.com>> wrote:
I don't know if we have A/B testing capabilities, but I'm cool with
changing the text to "Edit on GitHub". Also, we have like 10 open PRs for
docs from contributors, so the buttons definitely work. :)
I'll make the change for "Edit on GitHub" unless someone objects.
Kindly,
Dmitry
-----Original Message-----
From: Jesse [mailto:purplecabbage@gmail.com]
Sent: Tuesday, March 8, 2016 11:26 AM
To: dev@cordova.apache.org<ma...@cordova.apache.org>
Subject: Re: Edit to Edit on Github for Docs
+1 to AB testing!
On Mar 8, 2016, at 11:02 AM, Steven Gill <st...@gmail.com>>
wrote:
Look at us talking UX. Lets do some AB testing while we are at ;)
On Tue, Mar 8, 2016 at 10:54 AM, Nikhil Khandelwal
<ni...@microsoft.com>>
wrote:
+1 for trying "Edit on Github" - anything that _may_ increase
contributions to the docs is welcome. :)
-Nikhil
-----Original Message-----
From: Shazron [mailto:shazron@gmail.com]
Sent: Tuesday, March 8, 2016 10:26 AM
To: dev@cordova.apache.org<ma...@cordova.apache.org>
Subject: Re: Edit to Edit on Github for Docs
I'm ambivalent. "Edit" is concise, and I would think most are curious
enough to just click and see?
On Tue, Mar 8, 2016 at 8:50 AM, Carlos Santana <cs...@gmail.com>>
wrote:
The other day I was looking like crazy the doc source code that
corresponded to the page that a user was asking here in dev list
where was the source code, so I assume he also didn't see the "Edit"
Then someone pointed out there is an "Edit" link/button at the top
right side of each page.
Then I saw another website, can't remember now, but they had "Edit
on Github" and having the "on Github" capture my attention.
What you guys think about change it from "Edit" to "Edit on Github"
is that a good change or it's just me
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org<ma...@cordova.apache.org>
For additional commands, e-mail: dev-help@cordova.apache.org<ma...@cordova.apache.org>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org<ma...@cordova.apache.org>
For additional commands, e-mail: dev-help@cordova.apache.org<ma...@cordova.apache.org>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org<ma...@cordova.apache.org>
For additional commands, e-mail: dev-help@cordova.apache.org<ma...@cordova.apache.org>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org<ma...@cordova.apache.org>
For additional commands, e-mail: dev-help@cordova.apache.org<ma...@cordova.apache.org>
Re: Edit to Edit on Github for Docs
Posted by Robert Posener <rp...@gmail.com>.
Also, can we add "Edit on GitHub" to Blog and Plugin pages, please.
Regards
*Rob Posener*
0419 012 627
On 10 March 2016 at 09:14, Robert Posener <rp...@gmail.com> wrote:
> I like "Edit on GitHub".
>
> I was never sure how far into "editing" clicking on the "Edit" button
> would take me before I hit some roadblock (like needing to be a committer,
> like having a GitHub login, like being part of the cordova in-crowd, etc)
> that meant that I had wasted my time. It would be nice to clarify this
> (eg, a hover tip like "No login necessary - Will be queued for review by
> committers").
> Also... where is the "Edit" button documented?
>
> Rob
>
> Regards
> *Rob Posener*
> 0419 012 627
>
> On 9 March 2016 at 10:29, Dmitry Blotsky <db...@microsoft.com> wrote:
>
>> I don't know if we have A/B testing capabilities, but I'm cool with
>> changing the text to "Edit on GitHub". Also, we have like 10 open PRs for
>> docs from contributors, so the buttons definitely work. :)
>>
>> I'll make the change for "Edit on GitHub" unless someone objects.
>>
>> Kindly,
>> Dmitry
>>
>> -----Original Message-----
>> From: Jesse [mailto:purplecabbage@gmail.com]
>> Sent: Tuesday, March 8, 2016 11:26 AM
>> To: dev@cordova.apache.org
>> Subject: Re: Edit to Edit on Github for Docs
>>
>> +1 to AB testing!
>>
>>
>> > On Mar 8, 2016, at 11:02 AM, Steven Gill <st...@gmail.com>
>> wrote:
>> >
>> > Look at us talking UX. Lets do some AB testing while we are at ;)
>> >
>> > On Tue, Mar 8, 2016 at 10:54 AM, Nikhil Khandelwal
>> > <ni...@microsoft.com>
>> > wrote:
>> >
>> >> +1 for trying "Edit on Github" - anything that _may_ increase
>> >> contributions to the docs is welcome. :)
>> >>
>> >> -Nikhil
>> >>
>> >> -----Original Message-----
>> >> From: Shazron [mailto:shazron@gmail.com]
>> >> Sent: Tuesday, March 8, 2016 10:26 AM
>> >> To: dev@cordova.apache.org
>> >> Subject: Re: Edit to Edit on Github for Docs
>> >>
>> >> I'm ambivalent. "Edit" is concise, and I would think most are curious
>> >> enough to just click and see?
>> >>
>> >> On Tue, Mar 8, 2016 at 8:50 AM, Carlos Santana <cs...@gmail.com>
>> >> wrote:
>> >>> The other day I was looking like crazy the doc source code that
>> >>> corresponded to the page that a user was asking here in dev list
>> >>> where was the source code, so I assume he also didn't see the "Edit"
>> >>>
>> >>> Then someone pointed out there is an "Edit" link/button at the top
>> >>> right side of each page.
>> >>>
>> >>> Then I saw another website, can't remember now, but they had "Edit
>> >>> on Github" and having the "on Github" capture my attention.
>> >>>
>> >>> What you guys think about change it from "Edit" to "Edit on Github"
>> >>> is that a good change or it's just me
>> >>
>> >> ---------------------------------------------------------------------
>> >> To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org
>> >> For additional commands, e-mail: dev-help@cordova.apache.org
>> >>
>> >>
>> >> ---------------------------------------------------------------------
>> >> To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org
>> >> For additional commands, e-mail: dev-help@cordova.apache.org
>> >>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org
>> For additional commands, e-mail: dev-help@cordova.apache.org
>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org
>> For additional commands, e-mail: dev-help@cordova.apache.org
>>
>>
>
Re: Edit to Edit on Github for Docs
Posted by Robert Posener <rp...@gmail.com>.
I like "Edit on GitHub".
I was never sure how far into "editing" clicking on the "Edit" button would
take me before I hit some roadblock (like needing to be a committer, like
having a GitHub login, like being part of the cordova in-crowd, etc) that
meant that I had wasted my time. It would be nice to clarify this (eg, a
hover tip like "No login necessary - Will be queued for review by
committers").
Also... where is the "Edit" button documented?
Rob
Regards
*Rob Posener*
0419 012 627
On 9 March 2016 at 10:29, Dmitry Blotsky <db...@microsoft.com> wrote:
> I don't know if we have A/B testing capabilities, but I'm cool with
> changing the text to "Edit on GitHub". Also, we have like 10 open PRs for
> docs from contributors, so the buttons definitely work. :)
>
> I'll make the change for "Edit on GitHub" unless someone objects.
>
> Kindly,
> Dmitry
>
> -----Original Message-----
> From: Jesse [mailto:purplecabbage@gmail.com]
> Sent: Tuesday, March 8, 2016 11:26 AM
> To: dev@cordova.apache.org
> Subject: Re: Edit to Edit on Github for Docs
>
> +1 to AB testing!
>
>
> > On Mar 8, 2016, at 11:02 AM, Steven Gill <st...@gmail.com> wrote:
> >
> > Look at us talking UX. Lets do some AB testing while we are at ;)
> >
> > On Tue, Mar 8, 2016 at 10:54 AM, Nikhil Khandelwal
> > <ni...@microsoft.com>
> > wrote:
> >
> >> +1 for trying "Edit on Github" - anything that _may_ increase
> >> contributions to the docs is welcome. :)
> >>
> >> -Nikhil
> >>
> >> -----Original Message-----
> >> From: Shazron [mailto:shazron@gmail.com]
> >> Sent: Tuesday, March 8, 2016 10:26 AM
> >> To: dev@cordova.apache.org
> >> Subject: Re: Edit to Edit on Github for Docs
> >>
> >> I'm ambivalent. "Edit" is concise, and I would think most are curious
> >> enough to just click and see?
> >>
> >> On Tue, Mar 8, 2016 at 8:50 AM, Carlos Santana <cs...@gmail.com>
> >> wrote:
> >>> The other day I was looking like crazy the doc source code that
> >>> corresponded to the page that a user was asking here in dev list
> >>> where was the source code, so I assume he also didn't see the "Edit"
> >>>
> >>> Then someone pointed out there is an "Edit" link/button at the top
> >>> right side of each page.
> >>>
> >>> Then I saw another website, can't remember now, but they had "Edit
> >>> on Github" and having the "on Github" capture my attention.
> >>>
> >>> What you guys think about change it from "Edit" to "Edit on Github"
> >>> is that a good change or it's just me
> >>
> >> ---------------------------------------------------------------------
> >> To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org
> >> For additional commands, e-mail: dev-help@cordova.apache.org
> >>
> >>
> >> ---------------------------------------------------------------------
> >> To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org
> >> For additional commands, e-mail: dev-help@cordova.apache.org
> >>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org
> For additional commands, e-mail: dev-help@cordova.apache.org
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org
> For additional commands, e-mail: dev-help@cordova.apache.org
>
>
RE: Edit to Edit on Github for Docs
Posted by Dmitry Blotsky <db...@microsoft.com>.
I don't know if we have A/B testing capabilities, but I'm cool with changing the text to "Edit on GitHub". Also, we have like 10 open PRs for docs from contributors, so the buttons definitely work. :)
I'll make the change for "Edit on GitHub" unless someone objects.
Kindly,
Dmitry
-----Original Message-----
From: Jesse [mailto:purplecabbage@gmail.com]
Sent: Tuesday, March 8, 2016 11:26 AM
To: dev@cordova.apache.org
Subject: Re: Edit to Edit on Github for Docs
+1 to AB testing!
> On Mar 8, 2016, at 11:02 AM, Steven Gill <st...@gmail.com> wrote:
>
> Look at us talking UX. Lets do some AB testing while we are at ;)
>
> On Tue, Mar 8, 2016 at 10:54 AM, Nikhil Khandelwal
> <ni...@microsoft.com>
> wrote:
>
>> +1 for trying "Edit on Github" - anything that _may_ increase
>> contributions to the docs is welcome. :)
>>
>> -Nikhil
>>
>> -----Original Message-----
>> From: Shazron [mailto:shazron@gmail.com]
>> Sent: Tuesday, March 8, 2016 10:26 AM
>> To: dev@cordova.apache.org
>> Subject: Re: Edit to Edit on Github for Docs
>>
>> I'm ambivalent. "Edit" is concise, and I would think most are curious
>> enough to just click and see?
>>
>> On Tue, Mar 8, 2016 at 8:50 AM, Carlos Santana <cs...@gmail.com>
>> wrote:
>>> The other day I was looking like crazy the doc source code that
>>> corresponded to the page that a user was asking here in dev list
>>> where was the source code, so I assume he also didn't see the "Edit"
>>>
>>> Then someone pointed out there is an "Edit" link/button at the top
>>> right side of each page.
>>>
>>> Then I saw another website, can't remember now, but they had "Edit
>>> on Github" and having the "on Github" capture my attention.
>>>
>>> What you guys think about change it from "Edit" to "Edit on Github"
>>> is that a good change or it's just me
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org
>> For additional commands, e-mail: dev-help@cordova.apache.org
>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org
>> For additional commands, e-mail: dev-help@cordova.apache.org
>>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org
For additional commands, e-mail: dev-help@cordova.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org
For additional commands, e-mail: dev-help@cordova.apache.org
Re: Edit to Edit on Github for Docs
Posted by Jesse <pu...@gmail.com>.
+1 to AB testing!
> On Mar 8, 2016, at 11:02 AM, Steven Gill <st...@gmail.com> wrote:
>
> Look at us talking UX. Lets do some AB testing while we are at ;)
>
> On Tue, Mar 8, 2016 at 10:54 AM, Nikhil Khandelwal <ni...@microsoft.com>
> wrote:
>
>> +1 for trying "Edit on Github" - anything that _may_ increase
>> contributions to the docs is welcome. :)
>>
>> -Nikhil
>>
>> -----Original Message-----
>> From: Shazron [mailto:shazron@gmail.com]
>> Sent: Tuesday, March 8, 2016 10:26 AM
>> To: dev@cordova.apache.org
>> Subject: Re: Edit to Edit on Github for Docs
>>
>> I'm ambivalent. "Edit" is concise, and I would think most are curious
>> enough to just click and see?
>>
>> On Tue, Mar 8, 2016 at 8:50 AM, Carlos Santana <cs...@gmail.com>
>> wrote:
>>> The other day I was looking like crazy the doc source code that
>>> corresponded to the page that a user was asking here in dev list where
>>> was the source code, so I assume he also didn't see the "Edit"
>>>
>>> Then someone pointed out there is an "Edit" link/button at the top
>>> right side of each page.
>>>
>>> Then I saw another website, can't remember now, but they had "Edit on
>>> Github" and having the "on Github" capture my attention.
>>>
>>> What you guys think about change it from "Edit" to "Edit on Github" is
>>> that a good change or it's just me
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org
>> For additional commands, e-mail: dev-help@cordova.apache.org
>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org
>> For additional commands, e-mail: dev-help@cordova.apache.org
>>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org
For additional commands, e-mail: dev-help@cordova.apache.org
Re: Edit to Edit on Github for Docs
Posted by Steven Gill <st...@gmail.com>.
Look at us talking UX. Lets do some AB testing while we are at ;)
On Tue, Mar 8, 2016 at 10:54 AM, Nikhil Khandelwal <ni...@microsoft.com>
wrote:
> +1 for trying "Edit on Github" - anything that _may_ increase
> contributions to the docs is welcome. :)
>
> -Nikhil
>
> -----Original Message-----
> From: Shazron [mailto:shazron@gmail.com]
> Sent: Tuesday, March 8, 2016 10:26 AM
> To: dev@cordova.apache.org
> Subject: Re: Edit to Edit on Github for Docs
>
> I'm ambivalent. "Edit" is concise, and I would think most are curious
> enough to just click and see?
>
> On Tue, Mar 8, 2016 at 8:50 AM, Carlos Santana <cs...@gmail.com>
> wrote:
> > The other day I was looking like crazy the doc source code that
> > corresponded to the page that a user was asking here in dev list where
> > was the source code, so I assume he also didn't see the "Edit"
> >
> > Then someone pointed out there is an "Edit" link/button at the top
> > right side of each page.
> >
> > Then I saw another website, can't remember now, but they had "Edit on
> > Github" and having the "on Github" capture my attention.
> >
> > What you guys think about change it from "Edit" to "Edit on Github" is
> > that a good change or it's just me
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org
> For additional commands, e-mail: dev-help@cordova.apache.org
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org
> For additional commands, e-mail: dev-help@cordova.apache.org
>
RE: Edit to Edit on Github for Docs
Posted by Nikhil Khandelwal <ni...@microsoft.com>.
+1 for trying "Edit on Github" - anything that _may_ increase contributions to the docs is welcome. :)
-Nikhil
-----Original Message-----
From: Shazron [mailto:shazron@gmail.com]
Sent: Tuesday, March 8, 2016 10:26 AM
To: dev@cordova.apache.org
Subject: Re: Edit to Edit on Github for Docs
I'm ambivalent. "Edit" is concise, and I would think most are curious enough to just click and see?
On Tue, Mar 8, 2016 at 8:50 AM, Carlos Santana <cs...@gmail.com> wrote:
> The other day I was looking like crazy the doc source code that
> corresponded to the page that a user was asking here in dev list where
> was the source code, so I assume he also didn't see the "Edit"
>
> Then someone pointed out there is an "Edit" link/button at the top
> right side of each page.
>
> Then I saw another website, can't remember now, but they had "Edit on
> Github" and having the "on Github" capture my attention.
>
> What you guys think about change it from "Edit" to "Edit on Github" is
> that a good change or it's just me
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org
For additional commands, e-mail: dev-help@cordova.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org
For additional commands, e-mail: dev-help@cordova.apache.org
Re: Edit to Edit on Github for Docs
Posted by Shazron <sh...@gmail.com>.
I'm ambivalent. "Edit" is concise, and I would think most are curious
enough to just click and see?
On Tue, Mar 8, 2016 at 8:50 AM, Carlos Santana <cs...@gmail.com> wrote:
> The other day I was looking like crazy the doc source code that
> corresponded to the page that a user was asking here in dev list where was
> the source code, so I assume he also didn't see the "Edit"
>
> Then someone pointed out there is an "Edit" link/button at the top right
> side of each page.
>
> Then I saw another website, can't remember now, but they had "Edit on
> Github" and having the "on Github" capture my attention.
>
> What you guys think about change it from "Edit" to "Edit on Github" is that
> a good change or it's just me
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org
For additional commands, e-mail: dev-help@cordova.apache.org
Re: Edit to Edit on Github for Docs
Posted by Carlos Santana <cs...@gmail.com>.
Duh now I remembered.
https://console.ng.bluemix.net/docs/services/mobile.html
It's an IBM page, but still I think the change is still valuable, as user
see "Edit" and might think they need a login account, and if they see "on
Github" they can see that they will go to Github and related that with
source and no special website login, just Github login.
On Tue, Mar 8, 2016 at 11:50 AM Carlos Santana <cs...@gmail.com> wrote:
> The other day I was looking like crazy the doc source code that
> corresponded to the page that a user was asking here in dev list where was
> the source code, so I assume he also didn't see the "Edit"
>
> Then someone pointed out there is an "Edit" link/button at the top right
> side of each page.
>
> Then I saw another website, can't remember now, but they had "Edit on
> Github" and having the "on Github" capture my attention.
>
> What you guys think about change it from "Edit" to "Edit on Github" is
> that a good change or it's just me
>