directory-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From szoer...@apache.org
Subject svn commit: r647504 - /directory/sandbox/szoerner/apacheds-documentation/tutorial/src/main/docbook/howToBegin/someBackground.xml
Date Sat, 12 Apr 2008 22:47:36 GMT
Author: szoerner
Date: Sat Apr 12 15:47:11 2008
New Revision: 647504

URL: http://svn.apache.org/viewvc?rev=647504&view=rev
Log:
Some content from the wiki added

Modified:
    directory/sandbox/szoerner/apacheds-documentation/tutorial/src/main/docbook/howToBegin/someBackground.xml

Modified: directory/sandbox/szoerner/apacheds-documentation/tutorial/src/main/docbook/howToBegin/someBackground.xml
URL: http://svn.apache.org/viewvc/directory/sandbox/szoerner/apacheds-documentation/tutorial/src/main/docbook/howToBegin/someBackground.xml?rev=647504&r1=647503&r2=647504&view=diff
==============================================================================
--- directory/sandbox/szoerner/apacheds-documentation/tutorial/src/main/docbook/howToBegin/someBackground.xml
(original)
+++ directory/sandbox/szoerner/apacheds-documentation/tutorial/src/main/docbook/howToBegin/someBackground.xml
Sat Apr 12 15:47:11 2008
@@ -1,28 +1,97 @@
 <!--
-  Licensed to the Apache Software Foundation (ASF) under one
-  or more contributor license agreements.  See the NOTICE file
-  distributed with this work for additional information
-  regarding copyright ownership.  The ASF licenses this file
-  to you under the Apache License, Version 2.0 (the
-  "License"); you may not use this file except in compliance
-  with the License.  You may obtain a copy of the License at
-
-    http://www.apache.org/licenses/LICENSE-2.0
-
-  Unless required by applicable law or agreed to in writing,
-  software distributed under the License is distributed on an
-  "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-  KIND, either express or implied.  See the License for the
-  specific language governing permissions and limitations
-  under the License.
--->
+	Licensed to the Apache Software Foundation (ASF) under one
+	or more contributor license agreements.  See the NOTICE file
+	distributed with this work for additional information
+	regarding copyright ownership.  The ASF licenses this file
+	to you under the Apache License, Version 2.0 (the
+	"License"); you may not use this file except in compliance
+	with the License.  You may obtain a copy of the License at
+	
+	http://www.apache.org/licenses/LICENSE-2.0
 	
-	<section id="someBackground">
-		<title>Some Background. Directories, directory services and LDAP</title>
+	Unless required by applicable law or agreed to in writing,
+	software distributed under the License is distributed on an
+	"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+	KIND, either express or implied.  See the License for the
+	specific language governing permissions and limitations
+	under the License.
+-->
+
+<section id="someBackground">
+	<title>
+		Some Background. Directories, directory services and LDAP
+	</title>
+
+	<para>
+		This section provides a brief overview about directories,
+		directory services and LDAP. Furthermore you find links to
+		different resources (books, online resources, ...), which may
+		act as introduction to the topic. If you are already an LDAP
+		expert, you'll probably skip this section.
+	</para>
+
+	<section>
+		<title>Directories and directory services</title>
+
+		<para>
+			Generally speaking, a directory is a collection or list of
+			data. Real world examples are telephone books (public or
+			within organizations), church/land registers and listings of
+			works (e.g. the Koechel-index, which lists all compositions
+			of Mozart). All these examples have the purpose to preserve
+			information and to make it available on demand to whom it
+			may concern.
+		</para>
+
+		<para>
+			Within information technology the term directory is used for
+			a special kind of data storage. It allows the structured
+			storage and efficient retrieval of objects which are often
+			derived from the real world (e.g. persons, IT equipment).
+			Characteristic:
+			<!--  TODO Bullet list -->
+		</para>
+
 		<para>
-		 	This section provides a brief overview about directories, directory services and LDAP.

-                  Furthermore you find links to different resources (books, online resources,
...), 
-                  which may act as introduction to the topic. If you are already an LDAP
expert, 
-                  you'll probably skip this section.
-		</para>		
-	</section>	
+			A directory service is a solution which offers users access
+			to the information stored in the directory. A directory
+			assistance (call center agent) is a good real world example
+			for such a service. Within information technologies, such
+			services are normally provided by software components.
+			Directory services provide access to the content of a
+			directory via a well-defined interface. If a network is
+			used, an appropriate protocol has to be defined. LDAP (see
+			below) is such a protocol.
+		</para>
+
+		<para>
+			The real world examples mentioned above may be stored in
+			such a directory, although other types of storage systems
+			can be more appropriate (this depends on
+			circumstance/requirements). At first sight directories
+			compete thereby as data storage with the established
+			relational data bases. However in the most large enterprises
+			and organizations both directory services and relational
+			databases are actually used. Read how Vikas Mahajan
+			describes directories and databases as complementary, not
+			competitive, solutions in his excellent article "Should I
+			Use a Directory, a Database, or Both?".
+			
+			<!-- TODO: Link -->
+		</para>
+
+	</section>
+
+	<section>
+		<title>LDAP – the Lightweight Directory Access Protocol</title>
+
+	</section>
+
+	<section>
+		<title>LDAP resources</title>
+
+	</section>
+
+
+
+</section>



Mime
View raw message