incubator-ctakes-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From blee...@apache.org
Subject svn commit: r1449215 - /incubator/ctakes/site/trunk/content/ctakes/ppmc-faqs.mdtext
Date Fri, 22 Feb 2013 21:10:38 GMT
Author: bleeker
Date: Fri Feb 22 21:10:38 2013
New Revision: 1449215

URL: http://svn.apache.org/r1449215
Log:
CMS commit to ctakes by bleeker

Modified:
    incubator/ctakes/site/trunk/content/ctakes/ppmc-faqs.mdtext

Modified: incubator/ctakes/site/trunk/content/ctakes/ppmc-faqs.mdtext
URL: http://svn.apache.org/viewvc/incubator/ctakes/site/trunk/content/ctakes/ppmc-faqs.mdtext?rev=1449215&r1=1449214&r2=1449215&view=diff
==============================================================================
--- incubator/ctakes/site/trunk/content/ctakes/ppmc-faqs.mdtext (original)
+++ incubator/ctakes/site/trunk/content/ctakes/ppmc-faqs.mdtext Fri Feb 22 21:10:38 2013
@@ -19,18 +19,18 @@ Notice:    Licensed to the Apache Softwa
 ### What is the PPMC?
 
 The Podling Project Management Committee (PPMC) is the government of the project. It
-consists of ASF mentors and initial committers. The committee is responsible for the
+consists of ASF mentors and initial Committers. The committee is responsible for the
 project and decides what to do and which direction to go.
 <br> (See [here][1] for more information.)
 
 ### How to participate?
 
 First of all you have to think how you want to participate as we have different kind
-of roles like user, developer, committer. The easiest way is to use what we build as a
+of roles like user, developer, Committer. The easiest way is to use what we build as a
 user. If you want to improve parts of the software, or documentation, write to our
 [mailing lists][2] what should be modified and how it should be done.
 
-The following are conditions to become a committer:
+The following are conditions to become a Committer:
 
  1. You have sent in patches that were well-respected to improve the software.
  2. You have added documentation to the Wiki or website that were well-respected to
@@ -40,71 +40,84 @@ The following are conditions to become a
  4. You are well known to the established members, who you are and what you have
     done in the past. Regarding this project, a former-one or another project.
 
-If 1 of the 4 statements above are true, then you can be voted in as committer.
+If 1 of the 4 statements above are true, then you can be voted in as Committer and should
start the process. 
+For more information from Apache Software foundation read their [Guide To Participation](http://incubator.apache.org/guides/participation.html).
 
-When the vote result is positive, you will be asked for some information to setup
-your committer status.
-<br> (See [here][3] for more information.)
+###I'd like to start the process to become a Committer
+After working with the cTAKES community for a little bit and people know you, you can express
your desire to any PPMC member and have them bring it up to the PPMC via the private mailing
lists. 
+The PPMC will vote on inviting you to be a Committer. 
+When the vote result is positive, you will be asked to follow the new Committer process below.
 
-### I was invited/voted as committer, so what's next?
+###I've just been voted in as a Committer.  What do I need to do?
 
-The following is a brief summary of what to expect as committer:
+First, congratulations.  Your contributions to the project have been noted and we 
+hope that as a Committer you will be even more active.
 
- 1. After your (individual Contributor License Agreement ([iCLA][4]) has been
-    received and registered, you will be invited to specify one or more preferred
-    Apache user names.
+But before you are officially given Committer permissions, there are a few 
+administrative steps to complete. 
 
-    **Important**: <br>
-    The e-mail address you provide in your iCLA will be used for the following
+The following is a brief summary of what to expect as Committer:
+
+ 1. Submit a signed [ICLA](http://www.apache.org/licenses/icla.txt) (individual 
+    Contributor License Agreement) to Apache. This could take a couple of days, longer if
you
+    submitted the ICLA via post. You can check when this has occurred when
+    your name appears in the [Unlisted ICLAs](http://people.apache.org/committer-index.html#unlistedclas)
section 
+    on the Apache Committers page.
+
+    **Important**: The e-mail address you provide in your iCLA will be used for the following
     communications with you.
 
     Please note that there is also a [Corporate Contributor License Agreement
     (CCLA)][5] if you want/have to commit in the name of a company or organization.
 
- 2. Choose one or more user name(s) that would be acceptable to you. These are short
-    names or abbreviation that will be used for a Unix account login.
-
-    **Example:** <br>
-    Your name is "John Doe", so an ID could be "johnd" or "jdoe". [Here you can see
-    if the ID is still free][6] or already given to another committer.
-    
-    Supply all other information that is requested. Return the ID requests as
-    instructed.
-
- 3. When your choices are returned, the first request that does not conflict with
-    an already-issued ID will be used to generate an Apache ID. Write them in
-    the order you would like to have, so the first one is the most wanted.
-
- 4. You will receive an e-mail, from "root@apache.org", that confirms the Apache
-    user name for you and also provides you with an initial password. There are also
-    instructions for changing your password. Please be patient as this mail can take
+ 2. Once the your ICLA has been recorded, you should send a note to the
+    [cTAKES PPMC](mailto:ctakes-private@incubator.apache.org) to request an Apache account.

+    You must include your **full name** and **email address**, as you entered in 
+    the ICLA, as well as your **preferred user ID**. Please 
+    [check first](http://people.apache.org/committer-index.html) that your preferred 
+    user ID is not already in use by another Apache Committer or provide a 
+    list in priority order of the user IDs that you prefer. For example, Your name 
+    is "John Doe", so an ID could be "johnd" or "jdoe".
+
+ 3. You will receive an e-mail, from "root@apache.org", that confirms the Apache
+    user ID for you, provides you with an initial password, and gives further instructions

+    including how to change your password. Please be patient as this email can take
     some days.
 
- 5. The ID will also be your Apache e-mail address. Note that the account will be
-    set up to forward all received mails to the e-mail address you supplied on your
-    iCLA. It is not a normal mail account but just for forwarding. After you have
-    the account there is also a way to associate your Apache e-mail address with
-    additional e-mail addresses that you have. (**ToDo**: Add a link to a how-to)
+ 4. The user ID will also be your Apache e-mail address. Note that an email account will
be
+    set up to forward all received emails to the e-mail address you supplied on your
+    iCLA. It is not a normal email account but just for forwarding. After you have
+    the account there is also a way to associate your Apache email address with
+    additional email addresses that you have. (**ToDo**: Add a link to a how-to)
+
+ 5. If you were also voted as a PPMC member, you should then 
+    [subscribe](mailto:ctakes-private-subscribe@incubator.apache.org) to the 
+    PPMC's private mailing list.
 
- 6. The ID and password will allow you to check in changes and new additions on the
+ 6. The user ID will allow you to check-in changes and new additions on the
     Apache SVN repository for the cTAKES incubator repository. The ability
-    to check in material on the SVN repository is important for more than code. All
-    committers will have an use for it.
+    to check-in material on the SVN repository is important for more than just code. All
+    Committers will have a use for it.
+
+ 7. Once your user ID is working you should add your name to the 
+    [people](http://ctakes.staging.apache.org/ctakes/people.html) in this community. 
+    This might be the first test of your ability to change this web site's pages. you'll

+    find an answer to that in another question on this page.
 
- 7. The ID and password will allow you to login to a personal Unix account on the
+ 8. The ID and password will allow you to login to a personal Unix account on the
     Apache server "people.apache.org". You can produce a personal website at this
     account as well as use it as a regular Unix (specifically, FreeBSD) account. You
     do not need to be able to use this account. You may find it useful as you become
-    more accomplished as a committer.  
+    more accomplished as a Committer.  
 
- 8. Being a committer also grants access to some non-public resources and mailing
-    lists. There are details in the [private committers SVN tree][7].
+ 9. Being a Committer also grants access to some non-public resources and mailing
+    lists. There are details in the [private Committers SVN tree][7].
 
- 9. If you do not already have a login for the [Apache cTAKES wiki][11], you should 
-    [acquire][12] a user ID on that wiki.
+ 10. If you do not already have a login for the [Apache cTAKES wiki][11], you should 
+    [acquire][12] a user ID on that wiki in order to contribute to documentation.
 
 
-See the [Guide for new committers][8] and the [Committers' FAQ][9] for more information.
+See the [Guide for new Committers][8] and the [Committers' FAQ][9] for more information.
 
 ### How and when to vote?
 
@@ -114,6 +127,36 @@ to come to a decision by discussions. Th
 that means also to count the votes and present the result. Every member has 1 vote.
 <br> (See [here][10] for more information.)
 
+###How do I edit this website?
+The quickest and most common way is to use the Apache CMS (wmd editor) from your browser.
If you are a committer, save this link ([Apache CMS Editor](javascript:void(location.href='https://cms.apache.org/redirect?uri='+escape(location.href))))
as a bookmark. While on a page, like this one, just click on the bookmark. You will enter
the edit/commit/publish environment. Tips on the less obvious:
+
+- If you are not a Committer, you can still use the same bookmark by signing in as *anonymous*.
See detailed how-to steps in the [Apache CMS Reference](http://www.apache.org/dev/cmsref.html#non-committer)
for non-committers.
+- The Submit button alone does not commit your changes. Use the Quick Commit checkbox.
+- There is no Cancel button or link; simply close any web page you have open.
+- Committed changes go to [Staged] but you have to wait for it before you publish. There
is a similar delay when you [Publish].
+- Use the [Apache CMS Reference](http://www.apache.org/dev/cmsref.html) for anything more.
+
+The pages on this website are written in [markdown syntax](http://www.simpleeditions.com/59001/markdown-an-introduction)
and stored in SVN at 
+[https://svn.apache.org/repos/asf/incubator/ctakes/site/](https://svn.apache.org/repos/asf/incubator/ctakes/site/).
+
+- Tables can be generated however each cell must be a single line of characters (no end of
lines).
+- Tables can include HTML so long as it is all on one line.
+
+It is possible to edit, stage and publish website updates from the command line as well.
Information on deeper website development is found on the [Website Development](http://www.apache.org/dev/cms.html)
page.
+
+###How do I add image or files to a page on this web site?
+Add the image or document to SVN first. Enter edit mode on any page and click the "ctakes"
link (upper-right). Select [Edit] next to *doc/* or *images/*.
+You must type a name in the *Add New File or Directory:* field first, then press Enter. Upload
your file. Use Quick Commit and Sumbit. Stage and publish as you do a web page. 
+
+Go back to editing the page of interest. Add this code for images and documents respectively:
+
+    :::markdown
+    ![Enter alt text](images/MyImage.format)
+    [Text for link](docs/MyDoc.format)
+
+###How do I get help from technical people at Apache for problems with our distribution lists
or web sites etc?
+Ultimately you can [issue a ticket](https://issues.apache.org/jira/browse/INFRA) with the
Apache infrastructure team, but they have a [web page](http://www.apache.org/dev/infra-contact)
for you to decide the best course of action.
+
 
   [1]: http://incubator.apache.org/guides/ppmc.html
   [2]: http://incubator.apache.org/ctakes/mailing-lists.html



Mime
View raw message