hints for doing an out of tree build

[openafs-wiki.git] / index.mdwn

diff --git a/index.mdwn b/index.mdwn
index 8642160..e2e8276 100644 (file)
--- a/index.mdwn
+++ b/index.mdwn
@@ -1,44 +1,64 @@
-Welcome to the OpenAFS wiki. This is a web-based collaboration area for collecting, maintaining, and distributing information about the AFS distributed filesystem and related topics..
-
-
-
-- [[What is AFS?|WhatIsAFS]]
-- [[GettingStarted]]
-- [[WindowsEndUserQuickStartGuide]]
-- [[Win2008R2ADasKDC]]
-- [[CreatingANewCell]]
-- [[AddOnsToolsAndUtilities]]
-- [[AFSFrequentlyAskedQuestions]]
-- [[WhereToGetHelp]]
-- [[AncientHistory]] (once upon a time)
-
-## For the Community
-
-- [[Contribute please?  A list of tiny and simple tasks|TinySimpleTasks]]
-- [[Plumbing - (Your) Contributed scripts and tools|Contrib]]
-- [[MaintainingDocumentation]]
-
-## For Developers
-
-- [[OpenAFSDevelopers]] - documentation for developers of [[OpenAFS]], including details of our revision control system, and lists of tasks that need doing.
-- AFS3 [[ProtocolInfo]]
-- [[NewProjects]]
-- [[CodeArchitecture]]
-- [[GateKeeping]]
-- [[How to build OpenAFS from Source|HowToBuildOpenAFSFromSource]]
-- [[How to build OpenAFS RPM packages|HowToBuildOpenAfsRpmPackages]]
-- [[DemandAttach]]
-- [[OpenAFSPioctlInterfaceDoc]]
-- [[OpenAFSDoxygenStyleGuide]]
-- [[OpenAFSWebsiteProjectPage]]
-- [[OpenAFSCachePinning]]
-- [[CacheManagerPorting]] (Some Notes)
-- [[Buildbot]]
-- [[Debugging]]
-- [[BackupMethods]]
+![andy][1]
+
+
+Welcome to the [OpenAFS][2] wiki. This is a web-based collaboration for
+collecting, maintaining, and distributing information about OpenAFS, an
+open-source implementation of the AFS distributed filesystem.
+
+OpenAFS is a caching, distributed, network-based filesystem for securely and
+efficiently sharing files over a private network or over the internet.  OpenAFS
+stores files on file servers. OpenAFS clients read and write data to
+the file servers. Data is cached locally by clients, making subsequent reads
+very fast.  File servers automatically notify clients when data is
+changed, keeping data in sync.  OpenAFS clients integrate with the client
+operating system to create a seamless network file system.  Client side support
+is provided for wide-range of operating systems, including Windows, MacOS,
+Solaris, and Linux.
+
+### Key features
+
+  * global namespace
+  * location transparency
+  * client-side caching
+  * read-only replication
+  * access control lists
+  * kerberos integration
+
+## Using OpenAFS
+
+  * [[Getting started|/Archive/GettingStarted]]
+  * [Documentation][3]
+  * [[Contributed guides and information|/Archive/GuidesAndInfo]]
+  * [[Frequently asked questions|/Archive/AFSFrequentlyAskedQuestions]]
+  * A [[list of sites using OpenAFS|/Archive/ListOfSitesUsingOpenAFS]]
+  * [[Binary Packages Available from Third Parties|/Archive/BinaryThirdParty]]
+
+## Get involved
+
+  * A [[list of tiny and simple tasks|/Archive/TinySimpleTasks]]
+  * [[Contributing scripts and tools|/Archive/Contrib]]
+  * [[Maintaining documentation|/Archive/MaintainingDocumentation]]
+  * OpenAFS [[developer documentation|/Archive/OpenAFSDevelopers]]
+  * OpenAFS project [[infrastructure|/Archive/openafsinfrastructure]]
+
+## Getting help
+
+  * [[Commercial Support|/support/WhereToGetHelp]]
+  * IRC [chat.freenode.net][4] channel #openafs
+  * [OpenAFS Mailing lists][5]
+    * Users and administrators -> OpenAFS-info
+    * Developers -> OpenAFS-devel
 
 ## About this wiki
 
-* [[Some information on how to use this site|ikiwiki]]
-* [[Orphaned pages|OrphanedPages]]
+  * How to use this [[wiki|ikiwiki]]
+  * Try out the wiki [[sandbox]]
+  * [[Site Map|WikiSiteMap]]
+  * [[Orphaned pages|WikiOrphanedPages]]
+  * [[Broken links|WikiBrokenLinks]]
 
+[1]: images/andy_juggles.jpg "Andy Juggles"
+[2]: http://www.openafs.org  "OpenAFS"
+[3]: http://docs.openafs.org/ "OpenAFS Documentation"
+[4]: http://webchat.freenode.net/?channels=%23openafs&uio=d4 "Freenode webchat"
+[5]: https://lists.openafs.org/mailman/listinfo "Mailing lists"