Good point !
Yes, it should be part of the "how to contribute" section. Let me add this.
Regards
JB
On 11/12/2015 10:50 AM, Christian Schneider wrote:
On 12.11.2015 10:40, Jean-Baptiste Onofré wrote:
2. I think it's already do-able for non committers: they can propose
PullRequests or patches. The drawback is maybe the documentation: how
to contribute and it should be on the website.
Documentation is nice but it must be a lot easier than: Fork repo, clone
to your system, edit, add, commit, push, pull request. Those are just
too many steps.
I recently found that you can edit a foreign file directly in github.
For example open this url:
https://github.com/apache/karaf/blob/master/manual/src/main/asciidoc/users-guide/jdbc.adoc
Then use the edit button. It will implicitly create a fork and a branch
on your account. When you then save it offers to directly commit and
create a pull request. That is almost as convenient as confluence.
We could just add an edit link from each page on the web to the
respective file at github.
Of course we would also need some documentation to tell people how the
workflow is and for example that they must publish their edits with
apache license or similar. The main thing though is to make the edit
flow as easy as possible.
Christian
--
Jean-Baptiste Onofré
[email protected]
http://blog.nanthrax.net
Talend - http://www.talend.com
