reorg the front page
authorMichael Meffie <mmeffie@sinenomine.net>
Mon, 3 Dec 2012 15:51:56 +0000 (10:51 -0500)
committerMichael Meffie <mmeffie@sinenomine.net>
Mon, 3 Dec 2012 15:51:56 +0000 (10:51 -0500)
Try to reorganize the front page so it is less of a cluttered
mess. Need to write a useful 'getting started' page.

GettingStarted.mdwn
GuidesAndInfo.mdwn [new file with mode: 0644]
index.mdwn

index e6437fc..9dcc47d 100644 (file)
@@ -1,42 +1,8 @@
-## <a name="Where to get AFS"></a> Where to get AFS
+[[!toc levels=3]]
 
-<table border="1" cellpadding="0" cellspacing="0">
-  <tr>
-    <th bgcolor="#99CCCC"><strong> Package </strong></th>
-    <th bgcolor="#99CCCC"><strong> HTTP/FTP </strong></th>
-    <th bgcolor="#99CCCC"><strong> AFS </strong></th>
-  </tr>
-  <tr>
-    <td>[[IBMAFS]]</td>
-    <td colspan="2"> Discontinued. </td>
-  </tr>
-  <tr>
-    <td>[[OpenAFS]]</td>
-    <td><a href="http://www.openafs.org/release/latest.html" target="_top">http://www.openafs.org/release/latest.html</a></td>
-    <td><a href="file:///afs/openafs.org/software/openafs/" target="_top">/afs/openafs.org/software/openafs</a></td>
-  </tr>
-  <tr>
-    <td>[[Arla]]</td>
-    <td><a href="http://www.stacken.kth.se/projekt/arla/" target="_top">http://www.stacken.kth.se/projekt/arla/</a></td>
-    <td><a href="file:///afs/stacken.kth.se/ftp/pub/arla/" target="_top">/afs/stacken.kth.se/ftp/pub/arla/</a></td>
-  </tr>
-</table>
+(This page will describe how to get started setting up OpenAFS servers and clients.)
 
-## <a name="What to do next?"></a> What to do next?
 
-- [[InstallOpenAFSClient]]
-- [[AFS Quick Start Guide for UNIX|AFSQuickStartGuideForUNIX]]
-- [[Example USS Templates|ExampleUSSTemplates]]
-- [AFS intro doc at Stanford](http://www.stanford.edu/services/afs/intro/)
-- [AFS into at IBM developerworks](http://www.ibm.com/developerworks/opensource/library/os-openafs-kerberos5/index.html)
+# See also #
 
-(old wiki-ized quick start guide, to be removed)
-
-* [[InstallingtheFirstAFSMachine]]
-* [[InstallingAdditionalServerMachines]]
-* [[InstallingAdditionalClientMachines]]
-
-
-----
-
-See: [[FrequentlyAskedQuestions]]
+* [[Creating a new AFS cell|CreatingANewCell]]
diff --git a/GuidesAndInfo.mdwn b/GuidesAndInfo.mdwn
new file mode 100644 (file)
index 0000000..e12503e
--- /dev/null
@@ -0,0 +1,26 @@
+Add your tips and information about setting and using OpenAFS on this
+page.
+
+[[!toc levels=3]]
+
+## Setup ##
+
+* [[Creating a new AFS cell|CreatingANewCell]]
+* [[OpenAFS client install|InstallOpenAFSClient]]
+
+### Windows ###
+
+* [[Windows quick start guide|WindowsEndUserQuickStartGuide]]
+* [[Windows kerberos 5 AFS service principal|WindowsK5AfsServicePrincipal]]
+* [[How to setup OpenAFS with Windows 2008 R2 AD server|Win2008R2ADasKDC]]
+
+## Administration ##
+
+* [[Backup methods|BackupMethods]]
+* [[Example USS Templates|ExampleUSSTemplates]]
+
+## External guides and information ##
+
+* [AFS intro doc at Stanford](http://www.stanford.edu/services/afs/intro/)
+* [AFS into at IBM developerworks](http://www.ibm.com/developerworks/opensource/library/os-openafs-kerberos5/index.html)
+
index d7c6544..5bd1fdd 100644 (file)
@@ -15,11 +15,7 @@ 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.
-
-### Features ###
+### Key features ###
 
 * global namespace
 * location transparency
@@ -28,29 +24,27 @@ Heimdal kerberos.
 * access control lists
 * kerberos integration
 
+### Learn more ###
+
+* List of sites using OpenAFS
+* Learn more about OpenAFS
 
-## Guides and information ##
+## Information for administrators ##
 
 * [[Getting started|GettingStarted]]
-* [[Creating a new AFS cell|CreatingANewCell]]
-* [[Frequently asked questions|AFSFrequentlyAskedQuestions]]
-* [[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]]
+* [Documentation](http://docs.openafs.org/)
+* [[Contributed guides and information|GuidesAndInfo]]
 * [[Where to get help|WhereToGetHelp]]
-* [[Backup methods|BackupMethods]]
-
+* [[Frequently asked questions|AFSFrequentlyAskedQuestions]]
 
 ## Get involved ##
 
 * [[A list of tiny and simple tasks|TinySimpleTasks]]
-* [[Contributed scripts and tools|Contrib]]
+* [[Contributing scripts and tools|Contrib]]
 * [[Maintaining documentation|MaintainingDocumentation]]
 
 
-## Developer information ##
+## Information for developers ##
 
 OpenAFS [[developer documentation|OpenAFSDevelopers]] includes details of our
 revision control system and lists of tasks that need doing.