You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@directory.apache.org by se...@apache.org on 2017/11/25 21:00:33 UTC
svn commit: r1816350 - /directory/site/trunk/content/sources.mdtext

Author: seelmann
Date: Sat Nov 25 21:00:33 2017
New Revision: 1816350

URL: http://svn.apache.org/viewvc?rev=1816350&view=rev
Log:
Update SCM URLs (svn->git). Remove ancient text.

Modified:
    directory/site/trunk/content/sources.mdtext

Modified: directory/site/trunk/content/sources.mdtext
URL: http://svn.apache.org/viewvc/directory/site/trunk/content/sources.mdtext?rev=1816350&r1=1816349&r2=1816350&view=diff
==============================================================================
--- directory/site/trunk/content/sources.mdtext (original)
+++ directory/site/trunk/content/sources.mdtext Sat Nov 25 21:00:33 2017
@@ -18,56 +18,63 @@ Notice: Licensed to the Apache Software
 
 # Sources
 
-Sources for the Apache Directory projects are currently managed through [Subversion](http://subversion.tigris.org|subversion.tigris.org), except for Fortress Core which is [git base](http://git-wip-us.apache.org/). For each project you can find a detailed description how to checkout and build the source on the project documentation. This page is just a short overview.
+Most sources for the Apache Directory projects are managed through Git, some parts still remain in Subversion. For each project you can find a detailed description how to checkout and build the source on the project documentation. This page is just a short overview.
 
-![Subversion](images/subversion_logo.png)
+## Web access
 
-## Web Access to Subversion
+If you just want to browse the source code, you can use one of the web interfaces:
 
-If you just want to browse the source code, you can use the [web interface to Subversion](http://svn.apache.org/viewvc/directory). This is current at all times.
+* [web interface to Gitbox](https://gitbox.apache.org/repos/asf?a=project_list&s=directory-)
+* [Web interface to Git WIP (old)](https://git-wip-us.apache.org/repos/asf?a=project_list&s=directory-)
+* [web interface to GitHub](https://github.com/apache?q=directory-)
+* [web interface to Subversion](https://svn.apache.org/viewvc/directory)
 
-## Web access to Git
+## Normal Git/Subversion Access
 
-If you just want to browse the source code, you can use the [web interface to Git](http://git-wip-us.apache.org/repos/asf?p=directory-fortress-core.git). This is current at all times.
+Anyone can clone a git repository or check code out from Subversion. You only need to specify a username and password in order to update a repository, and only Directory committers have the permissions to do that. We run Git and Subversion over standard HTTPS, so hopefully you won't have problems with intervening firewalls.
 
+### Check out from Git or Subversion
 
-## Normal Subversion/Git Access
+For Git use a command like:
 
-Anyone can check code out of Subversion. You only need to specify a username and password in order to update the Subversion repository, and only Directory committers have the permissions to do that. We run Subversion and Git over standard HTTP/HTTPS, so hopefully you won't have problems with intervening firewalls.
+    git clone https://gitbox.apache.org/repos/asf/directory-server.git
 
-### Check out from Subversion or Git
+For Subversion Use a command like:
 
-Again, anyone can do this. Use a command like:
+	svn checkout https://svn.apache.org/repos/asf/directory/apacheds/trunk
 
-	svn checkout http://svn.apache.org/repos/asf/directory/apacheds/trunk-with-dependencies
+The following table displays the URL of each project, and the URL where you can find information about how to build each project.
 
-or for Fortress :
+| Subproject / Documentation | SCM URL |
+|:-:|:-:|
+| ApacheDS  1.0 (not maintained) | [https://svn.apache.org/repos/asf/directory/apacheds/tags/1.0.2/](https://svn.apache.org/repos/asf/directory/apacheds/tags/1.0.2/) |
+| [ApacheDS  2.0](https://directory.apache.org/apacheds/advanced-ug/0.2-building-trunks.html) | [https://gitbox.apache.org/repos/asf/directory-server.git](https://gitbox.apache.org/repos/asf/directory-server.git) |
+| [Apache Directory Studio](https://directory.apache.org/studio/developers-guide.html) | [https://gitbox.apache.org/repos/asf/directory-studio.git](https://gitbox.apache.org/repos/asf/directory-studio.git) |
+| [Apache LDAP API](https://directory.apache.org/api/developer-guide.html) | [https://gitbox.apache.org/repos/asf/directory-ldap-api.git](https://gitbox.apache.org/repos/asf/directory-ldap-api.git) |
+| [Apache Mavibot](https://directory.apache.org/mavibot/developer-guide.html) | [https://gitbox.apache.org/repos/asf/directory-mavibot.git](https://gitbox.apache.org/repos/asf/directory-mavibot.git) |
+| [Apache Fortress Core](https://directory.apache.org/fortress/developer-guide.html) | [https://git-wip-us.apache.org/repos/asf/directory-fortress-core.git](https://git-wip-us.apache.org/repos/asf/directory-fortress-core.git) |
+| [Apache Fortress Realm](https://directory.apache.org/fortress/developer-guide.html) | [https://git-wip-us.apache.org/repos/asf/directory-fortress-realm.git](https://git-wip-us.apache.org/repos/asf/directory-fortress-realm.git) |
+| [Apache Fortress EnMasse (REST API)](https://directory.apache.org/fortress/developer-guide.html) | [https://git-wip-us.apache.org/repos/asf/directory-fortress-enmasse.git](https://git-wip-us.apache.org/repos/asf/directory-fortress-enmasse.git) |
+| [Apache Fortress Commander (Web UI)](https://directory.apache.org/fortress/developer-guide.html) | [https://git-wip-us.apache.org/repos/asf/directory-fortress-commander.git ](https://git-wip-us.apache.org/repos/asf/directory-fortress-commander.git ) |
+| [Apache Kerby)](https://directory.apache.org/kerby/developer-guide.html) | [https://git-wip-us.apache.org/repos/asf/directory-kerby.git ](https://git-wip-us.apache.org/repos/asf/directory-kerby.git ) |
+| Apache eSCIMo | [https://svn.apache.org/repos/asf/directory/escimo/trunk/](https://svn.apache.org/repos/asf/directory/escimo/trunk/) |
+| Apache Directory Site | [https://svn.apache.org/repos/asf/directory/site/trunk/](https://svn.apache.org/repos/asf/directory/site/trunk/) |
 
-    git clone http://git-wip-us.apache.org/repos/asf/directory-fortress-core.git fortress
+### Commit Changes
 
-to check out the current version of the server, for instance.
+Any Directory committer has commit access. Use your Apache user ID and LDAP password for authentication. You can change the password at [https://id.apache.org/](https://id.apache.org/).
 
-The following table displays the URL of each project, and the URL where you can find information about how to build each project.
+###  Commit changes to Git
 
-| Subproject / Documentation | SVN URL |
-|:-:|:-:|
-| ApacheDS  1.0 (not maintained) | [http://svn.apache.org/repos/asf/directory/apacheds/tags/1.0.2/](http://svn.apache.org/repos/asf/directory/apacheds/tags/1.0.2/) |
-| [ApacheDS  2.0 (trunk)](http://directory.apache.org/apacheds/advanced-ug/0.2-building-trunks.html) | [http://svn.apache.org/repos/asf/directory/apacheds/trunk-with-dependencies/](http://svn.apache.org/repos/asf/directory/apacheds/trunk-with-dependencies/) |
-| [Apache Directory Studio](http://directory.apache.org/studio/building.html) | [http://svn.apache.org/repos/asf/directory/studio/trunk/](http://svn.apache.org/repos/asf/directory/studio/trunk/) |
-| [Apache LDAP API](http://directory.apache.org/api/developer-guide.html) | [http://svn.apache.org/repos/asf/directory/shared/trunk/](http://svn.apache.org/repos/asf/directory/shared/trunk/) |
-| [Apache Mavibot](http://directory.apache.org/mavibot/developer-guide.html) | [http://svn.apache.org/repos/asf/directory/mavibot/trunk/](http://svn.apache.org/repos/asf/directory/mavibot/trunk/) |
-| [Apache eSCIMo](http://directory.apache.org/escimo/developer-guide.html) | [http://svn.apache.org/repos/asf/directory/escimo/trunk/](http://svn.apache.org/repos/asf/directory/escimo/trunk/) |
-| Apache Fortress Core | [http://git-wip-us.apache.org/repos/asf/directory-fortress-core.git](http://git-wip-us.apache.org/repos/asf/directory-fortress-core.git) |
-| Apache Fortress Realm | [http://git-wip-us.apache.org/repos/asf/directory-fortress-realm.git](http://git-wip-us.apache.org/repos/asf/directory-fortress-realm.git) |
-| Apache Fortress EnMasse (REST API) | [http://git-wip-us.apache.org/repos/asf/directory-fortress-enmasse.git](http://git-wip-us.apache.org/repos/asf/directory-fortress-enmasse.git) |
-| Apache Fortress Commander (Web UI) | [http://git-wip-us.apache.org/repos/asf/directory-fortress-commander.git ](http://git-wip-us.apache.org/repos/asf/directory-fortress-commander.git ) |
-| Apache Directory Site | [http://svn.apache.org/repos/asf/directory/site/trunk/](http://svn.apache.org/repos/asf/directory/site/trunk/) |
+You can use a command like this to commit, rebase possible remote changes, and push your changes to the repository:
 
-### Commit Changes to Subversion
+    git commit
+    git pull --rebase
+    git push
 
-Any Directory committer should have a shell account on svn.apache.org. Before you can commit, you'll need to set a Subversion password for yourself. To do that, log in to svn.apache.org and run the command svnpasswd.
+### Commit changes to Subversion
 
-Once your password is set, you can use a command like this to commit:
+You can use a command like this to commit:
 
 	svn commit
 
@@ -75,55 +82,22 @@ If Subversion can't figure out your user
 
 	svn --username you commit
 
-Subversion will prompt you for a password, and once you enter it once, it will remember it for you. Note this is the password you configured with svnpasswd, not your shell or other password.
-
-<DIV class="note" markdown="1">
-For committers to be able to commit modification, they should have had checked out the project files using **https** instead of **http**.
-</DIV>
-
-###  Commit changes to Git
-
-Any Directory committer should have a shell account on git-wip-us.apache.org.
-
-You can use a command like this to push your changes to the repository :
-
-    git push
-
-<DIV class="note" markdown="1">
-For committers to be able to commit modification, they should have had checked out the project files using **https** instead of **http**.
-</DIV>
-
-## Read Only Git Repositories
-
-There are also read only git repositories, which are mirroring the subversion repositories.
-
-| Subproject | GIT URL | GIT URL (HTTP) |
-|:-:|:-:|:-:|
-| Apache Directory Clients | git://git.apache.org/directory-clients.git | [http://git.apache.org/directory-clients.git](http://git.apache.org/directory-clients.git) |
-| Apache Directory Daemon | git://git.apache.org/directory-daemon.git | [http://git.apache.org/directory-daemon.git](http://git.apache.org/directory-daemon.git) |
-| Apache Directory Installers | git://git.apache.org/directory-installers.git | [http://git.apache.org/directory-installers.git](http://git.apache.org/directory-installers.git) |
-| Apache Directory Project | git://git.apache.org/directory-project.git | [http://git.apache.org/directory-project.git](http://git.apache.org/directory-project.git) |
-| Apache Directory Samples | git://git.apache.org/directory-samples.git | [http://git.apache.org/directory-samples.git](http://git.apache.org/directory-samples.git) |
-| Apache Directory Server | git://git.apache.org/directory-server.git | [http://git.apache.org/directory-server.git](http://git.apache.org/directory-server.git) |
-| Apache Directory Shared | git://git.apache.org/directory-shared.git | [http://git.apache.org/directory-shared.git](http://git.apache.org/directory-shared.git) |
-| Apache Directory Skins | git://git.apache.org/directory-skins.git | [http://git.apache.org/directory-skins.git](http://git.apache.org/directory-skins.git) |
-| Apache Directory Studio Plugin | git://git.apache.org/directory-studio-plugin.git | [http://git.apache.org/directory-studio-plugin.git](http://git.apache.org/directory-studio-plugin.git) |
-| Apache Directory Studio | git://git.apache.org/directory-studio.git | [http://git.apache.org/directory-studio.git](http://git.apache.org/directory-studio.git) |
+Subversion will prompt you for a password, and once you enter it once, it will remember it for you.
 
 ## Web Site
 
-The Web site itself is stored in a repository and can be updated easily. Let's see how it works.
+The Web site itself is stored in a SVN repository and can be updated easily. Let's see how it works.
 
 What is important here is that the pages are written using Markdown. Once a page has been modified, it can be committed, which will generate the static pages on a staging web site. When everything is checked and sounds correct, the staging site can be published on the production site, which will be pushed to the mirrors every hour. Here is the process :
 
 * Modify the markdown pages
 * Commit them
-* Check on the staging site to see if it's correct (see [http://directory.staging.apache.org/](http://directory.staging.apache.org/))
-* Publish the site using the [Apache CMS](http://www.apache.org/dev/cmsref.html)
+* Check on the staging site to see if it's correct (see [https://directory.staging.apache.org/](https://directory.staging.apache.org/))
+* Publish the site using the [Apache CMS](https://www.apache.org/dev/cmsref.html)
 
 ### Repository
 
-All the web site can be fetched at [https://svn.apache.org/repos/asf/directory/site/trunk/](http://svn.apache.org/repos/asf/directory/site/trunk/). Be sure to use *https* in order to be able to commit your changes...
+All the web site can be fetched at [https://svn.apache.org/repos/asf/directory/site/trunk/](https://svn.apache.org/repos/asf/directory/site/trunk/). Be sure to use *https* in order to be able to commit your changes...
 
 ### Structure
 The following structure is used :
@@ -160,6 +134,6 @@ Usually, you won't have to change the te
 
 ### Publishing the web site
 
-You have to install the [CMS bookmarklet](http://www.apache.org/dev/cms.html#usage) for that. Then simply open the directory web site and click on the bookmarklet, enter your apache credentials (you have to be a committer) and click on the 'Publish' button.
+You have to install the [CMS bookmarklet](https://www.apache.org/dev/cms.html#usage) for that. Then simply open the directory web site and click on the bookmarklet, enter your apache credentials (you have to be a committer) and click on the 'Publish' button.
 
-The best way to undertand how to use the CMS system is to follow [this video](https://www.youtube.com/watch?v=xcDZN3Lu6HA).
+The best way to understand how to use the CMS system is to follow [this video](https://www.youtube.com/watch?v=xcDZN3Lu6HA).