bulletize indexes
[openafs-wiki.git] / index.mdwn
index 8d8031f..e67ddae 100644 (file)
@@ -1,80 +1,57 @@
+![andy][1]
 
-<img id="andy" src="images/andy_juggles.jpg">
 
-Welcome to the [OpenAFS](http://www.openafs.org) wiki. This is a web-based
-collaboration area for collecting, maintaining, and distributing information
-about OpenAFS, an open-source implementation of the AFS distributed filesystem.
+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 server machines. OpenAFS clients read and write data to
+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 when data is
+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.
 
-OpenAFS requires a Kerberos 5 realm for mutual authentication of users and
-servers. Kerberos implementations include Active Directory, MIT Kerberos, and
-Heimdal kerberos.
+### Key features
 
-### Features ###
+  * global namespace
+  * location transparency
+  * client-side caching
+  * read-only replication
+  * access control lists
+  * kerberos integration
 
-* global namespace
-* location transparency
-* client-side caching
-* read-only replication
-* access control lists
-* kerberos integration
+For more information on the history of OpenAFS or a further how-to for
+this wiki page look at the [[general section|general/index]].
 
+## Developers
 
-## Guides and information
+Interested in getting involved? Check out the [[developer's
+section|devel/index]] to find information on getting started or picking up
+where you left off.
 
-* [[Getting started|GettingStarted]]
-* [[Creating a new AFS cell|CreatingANewCell]]
-* [[Windows quick start guide|WindowsEndUserQuickStartGuide]]
-* [[How to setup OpenAFS with Windows 2008 R2 AD server|Win2008R2ADasKDC]]
-* [[Windows kerberos 5 AFS service principal|WindowsK5AfsServicePrincipal]]
-* [[OpenAFS use case at CGV|usecase_cgv]]
-* [[Add-on tools and utilities|AddOnsToolsAndUtilities]]
-* [[Where to get help|WhereToGetHelp]]
-* [[Frequently asked questions|AFSFrequentlyAskedQuestions]]
+## Administrators
 
+Already have OpenAFS installed? Find information
+on continuing setup in the [[administrator's section|admin/index]].
 
-## For the Community
+## OpenAFS Users
 
-* [[A list of tiny and simple tasks|TinySimpleTasks]]
-* [[Contributed scripts and tools|Contrib]]
-* [[Maintaining documentation|MaintainingDocumentation]]
+Need more help navigating OpenAFS? Find further general reading here
+in the [[user's section|reguser/index]].
 
+## Getting help
 
-## For Developers
-
-* [[OpenAFS developer documentation|OpenAFSDevelopers]] - documentation for developers of [[OpenAFS]], including details of our revision control system, and lists of tasks that need doing.
-* [[AFS3 protocol information|ProtocolInfo]]
-* [[New projects|NewProjects]]
-* [[Code architecture|CodeArchitecture]]
-* [[Gatekeeping|GateKeeping]]
-* [[How to build OpenAFS from source|HowToBuildOpenAFSFromSource]]
-* [[How to build OpenAFS RPM packages|HowToBuildOpenAfsRpmPackages]]
-* [[Demand attach file server|DemandAttach]]
-* [[Pioctl interface documentation|OpenAFSPioctlInterfaceDoc]]
-* [[Doxygen style guide|OpenAFSDoxygenStyleGuide]]
-* [[Website project|OpenAFSWebsiteProjectPage]]
-* [[Cache pinning|OpenAFSCachePinning]]
-* [[Cache manager porting notes|CacheManagerPorting]]
-* [[Buildbot]]
-* [[Debugging]]
-* [[Backup methods|BackupMethods]]
-
-## About this wiki
-
-* [[How to use this wiki|ikiwiki]]
-* [[How to use git to edit pages|GitWiki]]
-* [[Try out the wiki sandbox|sandbox]]
-* [[Site Map|WikiSiteMap]]
-* [[Orphaned pages|WikiOrphanedPages]]
-* [[Broken links|WikiBrokenLinks]]
-
+  * [[Commercial Support|general/support/WhereToGetHelp]]
+  * IRC [chat.freenode.net][3] channel #openafs
+  * [OpenAFS Mailing lists][4]
+    * Users and administrators -> OpenAFS-info
+    * Developers -> OpenAFS-devel
 
+[1]: images/andy_juggles.jpg "Andy Juggles"
+[2]: http://www.openafs.org  "OpenAFS"
+[3]: http://webchat.freenode.net/?channels=%23openafs&uio=d4 "Freenode webchat"
+[4]: https://lists.openafs.org/mailman/listinfo "Mailing lists"