www-site-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Petrus Karell<pk@live.fi> <anonym...@apache.org>
Subject CMS diff: Contributors Tech Guide
Date Sat, 14 Mar 2015 18:21:15 GMT
Clone URL (Committers only):
https://cms.apache.org/redirect?new=anonymous;action=diff;uri=http://www.apache.org/dev%2Fcontributors.mdtext

Petrus Karell<pk@live.fi>

Index: trunk/content/dev/contributors.mdtext
===================================================================
--- trunk/content/dev/contributors.mdtext	(revision 1655892)
+++ trunk/content/dev/contributors.mdtext	(working copy)
@@ -42,46 +42,46 @@
 Bazaar](http://www.catb.org/~esr/writings/cathedral-bazaar/cathedral-bazaar/)
 paper and [Google](http://www.google.com/).
 
-# Getting sources from revision control (SVN or git) # {#svnbasics}
+# Revision control # {#revisioncontrol}
 
-Subversion (SVN), is the version control system used by most projects at Apache. See [The
-Subversion Homepage](http://subversion.apache.org/) for more about SVN.
-Some Apache projects [use git instead](http://www.apache.org/dev/git.html).
+Revision control (version control, source control) system is used to manage changes 
+to projects. Control system used by most projects at Apache is [Apache Subversion](http://subversion.apache.org/)
(SVN), 
+which is discussed below. For many projects there is additional read-only [git mirror](http://www.apache.org/dev/git.html).

+Some projects also use [git as their main source code repository](http://www.apache.org/dev/writable-git).
 
-## Bleeding-edge / Nightly code ## {#bleeding-edge}
+The subversion repository contains the bleeding edge version of a particular 
+project and additional older and special versions. The repository is commonly 
+devided to three top-level directories: `trunk`, `tags` and `branches`.
 
-Getting the source directly from the source repository usually gives you
-the bleeding edge version of that particular project. To be more precise,
-in the Subversion repository, there are usually three separate top-level
-directories: `trunk` , `tags` and `branches`.
+The `trunk` directory contains the current source code, and thus it is usually 
+used in the source code access URLs given by the projects.
 
-The `trunk` directory contains the current source code, and thus it's
-usually used in the source code access urls given by the projects.
+The `tags` directory contains specific versions of the project that were tagged 
+with some name for some specific reason. For instance, you usually find a tag 
+for each released version of the project.
 
-The `tags` directory contains specific versions of the project that were
-tagged with some name. These were created for some specific reason. For
-instance, you usually find a tag for each released version of the project.
+The `branches` directory finally contains versions of the project that are different 
+in some respect, such as experimental or former released versions.
 
-The branches directory finally contains versions of the project that are
-different in some respect, such as experimental versions, or former released
-versions.
+If you want the **stable** version of ASF project, download it from a [mirror site](http://www.apache.org/dyn/closer.cgi/).

+Only if the version you want is not on a mirror site, use the source repository.
 
-In short, if you are looking to download the source code for **stable** versions
-of the ASF projects, you should go to a normal [mirror site](http://www.apache.org/dyn/closer.cgi/)
-and simply download it from there. Only if you want the bleeding edge source
-(from the `trunk` folder, or if you need an older version for which you don't
-get the source code from the mirrors anymore, use the source repository.
+To start using source code from the source repository, you must first install 
+Subversion client. After installation, you may check out i.e. download projects 
+or parts of them to your local file system. For detailed info on using the 
+Subversion client, see the [Subversion book](http://svnbook.red-bean.com/).
 
-Before you start using source code from the source repository, you need to
-check out a local copy of the remote repository. Here's how.
-Subversion, which is the technology/tool used by Apache to maintain the
-source repository, is an open source project hosted by
-[Apache](http://subversion.apache.org/). You will find most tools noted
-here on this site or related sites at [Tigris](http://tigris.org) the
-previous home of Subversion. So, if your system is not listed here, please
-go to Tigris and see what options are available to you.
+# Installing Subversion client # {#svn-installing}
 
-For more details about the Subversion client, the [Subversion book](http://svnbook.red-bean.com/)
is the place to start.
+For Unix/Linux there are essentially two ways to use Subversion: command-line 
+tools and Subversion integration provided by IDEs. For Windows the 
+Subversion utilities are provided as native binaries as well, but you may 
+also choose to use Cygwin and the Unix binaries. In addition, there is easy 
+to use Windows shell extension, TortoiseSVN, which does not require separate 
+installation of the Subversion client software. IDEs might require installation 
+of a Subversion plugin, which is not part of the default IDE package. Moreover, 
+some IDEs, such as Netbeans, interact with the Subversion client, requiring you 
+to install it separately.
 
 ## Windows: Use cygwin ## {#svn-cygwin}
 
@@ -211,8 +211,8 @@
 
 # How to Provide feedback to Apache projects # {#providingfeedback}
 
-A valuable way to contribute to ASF projects is by using the software, and
-then providing feedback about them to its developers. Different software
+A valuable way to contribute to ASF projects is by using the software, 
+and then providing feedback about it to the developers. Different software
 projects have different preferences about how you should go around to
 submitting feedback. Check out the project website for more information. In
 absence of information on how to provide feedback on a project's website,


Mime
View raw message