You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@ctakes.apache.org by "Ewan Mellor (JIRA)" <ji...@apache.org> on 2018/03/08 18:51:00 UTC
[jira] [Updated] (CTAKES-499) cTakes has no documentation on how to
submit patches as an external contributor
[ https://issues.apache.org/jira/browse/CTAKES-499?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Ewan Mellor updated CTAKES-499:
-------------------------------
Description:
I have been looking for instructions on how to submit changes to cTakes. It’s been harder than I expected!
Firstly, I sent this as an email to [dev@ctakes.apache.org|mailto:dev@ctakes.apache.org] twice, and it did not get through both times. I am subscribed to the list. I presume that your spam filter dropped it, which means that it is dropping legitimate email from list subscribers.
On [https://cwiki.apache.org/confluence/display/CTAKES/cTAKES], there is a link labeled "Become a committer”, but that goes to [http://ctakes.apache.org/ppmc-faqs.html], which is a broken link.
I’m guessing that it was supposed to be [https://ctakes.apache.org/pmc-faqs.html]. On that page, it says "we have different kind of roles like user, developer, Committer ... The following are conditions to become a Committer: 1. You have sent in patches ..." It doesn’t say anything about how to actually send a patch.
On [https://cwiki.apache.org/confluence/display/CTAKES/cTAKES+4.0+Developer+Install+Guide], there is a description on how to get the source from Subversion, or Subversion + Git. It doesn’t explain why I would want to use two VCSs at the same time (?). It also doesn’t say anything about submitting changes, either through svn or git, nor GitHub or email.
On [https://ctakes.apache.org/developer-faqs.html], it says "Submit issues using JIRA. Anyone may read the issues. You must be a contributor to add or edit issues.” It doesn’t say how you become a contributor. It also isn't true, because here I am submitting an issue on Jira. I don't know why it says that in the FAQ. It initially put me off from filing a ticket.
On [https://cwiki.apache.org/confluence/display/CTAKES/Best+Practices] it says to create a Jira ticket and mention it in the commit message, but it also doesn’t say how to actually submit a patch. It looks like this page is intended for Committers (i.e. those with direct commit rights) but it doesn't say anything about best practices when you *don't* have commit rights.
For what it’s worth the Tika project has this page: [https://tika.apache.org/contribute.html], and their readme at [https://github.com/apache/tika/]. Between them they have instructions on where to file issues, how to submit patches through GitHub, and how to get changes reviewed. That’s the kind of info for cTakes that I was looking for. Other projects that I’ve worked with (Apache or otherwise) have taken patches through email, or a bug tracker, or a system like Gerrit. I’m trying to find out what cTakes is using.
I have changes that I would like to submit, but I am failing at the first hurdle.
was:
I have been looking for instructions on how to submit changes to cTakes. It’s been harder than I expected!
Firstly, I sent this as an email to [dev@ctakes.apache.org|mailto:dev@ctakes.apache.org] twice, and it did not get through both times. I am subscribed to the list. I presume that your spam filter dropped it, which means that it is dropping legitimate email from list subscribers.
On [https://cwiki.apache.org/confluence/display/CTAKES/cTAKES], there is a link labeled "Become a committer”, but that goes to [http://ctakes.apache.org/ppmc-faqs.html], which is a broken link.
I’m guessing that it was supposed to be [https://ctakes.apache.org/pmc-faqs.html]. On that page, it says "we have different kind of roles like user, developer, Committer ... The following are conditions to become a Committer: 1. You have sent in patches ..." It doesn’t say anything about how to actually send a patch.
On [https://cwiki.apache.org/confluence/display/CTAKES/cTAKES+4.0+Developer+Install+Guide], there is a description on how to get the source from Subversion, or Subversion + Git. It doesn’t explain why I would want to use two VCSs at the same time (?). It also doesn’t say anything about submitting changes, either through svn or git, nor GitHub or email.
On [https://ctakes.apache.org/developer-faqs.html], it says "Submit issues using JIRA. Anyone may read the issues. You must be a contributor to add or edit issues.” It doesn’t say how you become a contributor. It also isn't true, because here I am submitting an issue on Jira. I don't know why it says that in the FAQ. It initially put me off from filing a ticket.
On [https://cwiki.apache.org/confluence/display/CTAKES/Best+Practices] it says to create a Jira ticket and mention it in the commit message, but it also doesn’t say how to actually submit a patch. It looks like this page is intended for Committers (i.e. those with direct commit rights) but it doesn't say anything about best practices when you *don't* have commit rights.
For what it’s worth the Tika project has this page: [https://tika.apache.org/contribute.html], and their readme at [https://github.com/apache/tika/]. Between them they have instructions on where to file issues, how to submit patch through GitHub, and how to get changes reviewed. That’s the kind of info for cTakes that I was looking for. Other projects that I’ve worked with (Apache or otherwise) have taken patches through email, or a bug tracker, or a system like Gerrit. I’m trying to find out what cTakes is using.
I have changes that I would like to submit, but I am failing at the first hurdle.
> cTakes has no documentation on how to submit patches as an external contributor
> -------------------------------------------------------------------------------
>
> Key: CTAKES-499
> URL: https://issues.apache.org/jira/browse/CTAKES-499
> Project: cTAKES
> Issue Type: Improvement
> Reporter: Ewan Mellor
> Priority: Minor
>
> I have been looking for instructions on how to submit changes to cTakes. It’s been harder than I expected!
>
> Firstly, I sent this as an email to [dev@ctakes.apache.org|mailto:dev@ctakes.apache.org] twice, and it did not get through both times. I am subscribed to the list. I presume that your spam filter dropped it, which means that it is dropping legitimate email from list subscribers.
>
> On [https://cwiki.apache.org/confluence/display/CTAKES/cTAKES], there is a link labeled "Become a committer”, but that goes to [http://ctakes.apache.org/ppmc-faqs.html], which is a broken link.
>
> I’m guessing that it was supposed to be [https://ctakes.apache.org/pmc-faqs.html]. On that page, it says "we have different kind of roles like user, developer, Committer ... The following are conditions to become a Committer: 1. You have sent in patches ..." It doesn’t say anything about how to actually send a patch.
>
> On [https://cwiki.apache.org/confluence/display/CTAKES/cTAKES+4.0+Developer+Install+Guide], there is a description on how to get the source from Subversion, or Subversion + Git. It doesn’t explain why I would want to use two VCSs at the same time (?). It also doesn’t say anything about submitting changes, either through svn or git, nor GitHub or email.
>
> On [https://ctakes.apache.org/developer-faqs.html], it says "Submit issues using JIRA. Anyone may read the issues. You must be a contributor to add or edit issues.” It doesn’t say how you become a contributor. It also isn't true, because here I am submitting an issue on Jira. I don't know why it says that in the FAQ. It initially put me off from filing a ticket.
>
> On [https://cwiki.apache.org/confluence/display/CTAKES/Best+Practices] it says to create a Jira ticket and mention it in the commit message, but it also doesn’t say how to actually submit a patch. It looks like this page is intended for Committers (i.e. those with direct commit rights) but it doesn't say anything about best practices when you *don't* have commit rights.
>
> For what it’s worth the Tika project has this page: [https://tika.apache.org/contribute.html], and their readme at [https://github.com/apache/tika/]. Between them they have instructions on where to file issues, how to submit patches through GitHub, and how to get changes reviewed. That’s the kind of info for cTakes that I was looking for. Other projects that I’ve worked with (Apache or otherwise) have taken patches through email, or a bug tracker, or a system like Gerrit. I’m trying to find out what cTakes is using.
>
> I have changes that I would like to submit, but I am failing at the first hurdle.
>
--
This message was sent by Atlassian JIRA
(v7.6.3#76005)