Refactor file layout
[openafs-wiki.git] / index.mdwn
index dc014d7..bb9b6a6 100644 (file)
@@ -1,42 +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..
+![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.
 
-- [[What is AFS?|WhatIsAFS]]
-- [[GettingStarted]]
-- [[WindowsEndUserQuickStartGuide]]
-- [[Win2008R2ADasKDC]]
-- [[CreatingANewCell]]
-- [[AddOnsToolsAndUtilities]]
-- [[AFSFrequentlyAskedQuestions]]
-- [[WhereToGetHelp]]
-- [[AncientHistory]] (once upon a time)
+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.
 
-## <a name="For Community ..."></a> For the Community...
+### Key features
 
-- [[Contribute please?  A list of tiny and simple tasks|TinySimpleTasks]]
-- [[Plumbing - (Your) Contributed scripts and tools|Contrib]]
-- [[MaintainingDocumentation]]
+  * global namespace
+  * location transparency
+  * client-side caching
+  * read-only replication
+  * access control lists
+  * kerberos integration
 
-## <a name="For Developers ..."></a> For Developers ...
+## Using OpenAFS
 
-- [[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]]
+  * [[Getting started|GettingStarted]]
+  * [Documentation][3]
+  * [[Contributed guides and information|GuidesAndInfo]]
+  * [[Frequently asked questions|AFSFrequentlyAskedQuestions]]
+  * A [[list of sites using OpenAFS|ListOfSitesUsingOpenAFS]]
+  * [[Binary Packages Available from Third Parties|BinaryThirdParty]]
 
+## Get involved
 
-Note: This area is about AFS, whose name is properly spelled in all uppercase. Unfortunately, this creates interesting challenges in coming up with appropriate [[WikiWords|TWiki/WikiWord]] for naming topics. Please bear with us -- or come up with better names! 
+  * A [[list of tiny and simple tasks|TinySimpleTasks]]
+  * [[Contributing scripts and tools|Contrib]]
+  * [[Maintaining documentation|MaintainingDocumentation]]
+  * OpenAFS [[developer documentation|OpenAFSDevelopers]]
+  * OpenAFS project [[infrastructure|openafsinfrastructure]]
 
+## Getting help
+
+  * [[Commercial Support|WhereToGetHelp]]
+  * IRC [chat.freenode.net][4] channel #openafs
+  * [OpenAFS Mailing lists][5]
+    * Users and administrators -> OpenAFS-info
+    * Developers -> OpenAFS-devel
+
+## About this wiki
+
+  * 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"