[TYPO3-doc] Encouraging people to contribute with Github

[Fabien Udriot]

IMO, what is missing is a **visible** link on each page entitled 
"Improve this page" which leads directly to the Github editor. This 
would make the difference, I think.

Checkout how it is done by AngularJS http://docs.angularjs.org/api (the 
blue button on the top). This way, we will gain contribution.

Regards,

Fabien

---
TYPO3 - inspiring people to share!
Get involved: typo3.org
On 13 Feb 2014, at 22:52, François Suter wrote:

> Hi,
>
> Going back to this old topic.
>
>> Having discussed and tested this with Xavier, all I can say is that I 
>> am
>> positive about this. The process may be somewhat convoluted (for us,
>> maintainers) but it makes so much easier for people to contribute to 
>> the
>> documentation.
>
> Having been through all the motions, I can confirm that it's pretty 
> convoluted and I'm not sure it's worth it. Of course the idea was that 
> people would contribute mostly small corrections and that all those 
> commits could be squashed together in one larger commit to push to 
> Gerrit.
>
> Until now there have been only few contributions, some of which were 
> not trivial enough to be squashed with the others. The problem with 
> this is that a Forge issue must be created for each commit ported from 
> Github (and not squashed with another one) as we need a ChangeId to 
> push to Gerrit (and the script will refuse to do its job if there are 
> no "Resolves:" and "Releases:" tags. Furthermore if you have several 
> such commits to update, you can't just use "git commit --amend" 
> because that works only for the last commit. You have to interactive 
> rebase, amend each commit, then push them. If that were not enough, if 
> you start merging the first one in Gerrit, the next one will be 
> considered outdated. You have to pull to rebase, push again and repeat 
> for each commit.
>
> I'm not sure if this is really worth it. It's true that it brought a 
> few contributions which we may never have received if it weren't for 
> the Github fork, but the work it implies may offset the benefits.
>
> Cheers
>
> -- 
>
> Francois Suter
>
> Work: Cobweb Development Sarl - http://www.cobweb.ch
>
> TYPO3: Help the project! - http://typo3.org/contribute/
>
> Appreciate my work? Support me -
> http://www.monpetitcoin.com/en/francois/support-me/
> _______________________________________________
> TYPO3-project-documentation mailing list
> TYPO3-project-documentation at lists.typo3.org
> http://lists.typo3.org/cgi-bin/mailman/listinfo/typo3-project-documentation