NewSiteOutline.mdwn

   1 Russ Allbery
   2
   3 &gt;<cite> The next step would be to determine the set of questions that we believe</cite><br /> &gt;<cite> should be answered by each class of visitor.</cite><br />
   4
   5 Here's a first cut at that. This is somewhat off the top of my head, but I'll throw it out so that Jeff can comment on whether it's what he has in mind and so that you can get an idea of what we're thinking of.
   6
   7 This is **very** rough, just a seed for thought. I wouldn't necessarily organize a sitemap around exactly this outline, but it's sort of the concept flow that I envision for different users.
   8
   9 ## <a name="For Users"></a> For Users
  10
  11 - What is [[OpenAFS]] from a user's perspective?
  12 - Do you want to download the client?
  13   - For what platform?
  14   - Here's the recommended version for that platform.
  15   - Here are the release notes.
  16   - Here are older versions or other versions that may be appropriate in particular situations with their release notes.
  17 - What else do I need?
  18   - Network Identity Manager
  19 - How do I configure [[OpenAFS]] to work with my local site?
  20   - What questions do I need to ask my local support people if I can't find a local configuration page?
  21   - Some pointer to Kerberos configuration
  22 - Where's the manual?
  23 - Where can I get help?
  24   - Bug tracker
  25   - Mailing list archives
  26   - Mailing list subscription
  27
  28 ## <a name="For Admins"></a> For Admins
  29
  30 - Why, as a sysadmin, do I care about [[OpenAFS]]?
  31 - Do you want to download the latest server?
  32   - For what platform?
  33     - What's your recommended platform for a server if I don't care?
  34   - Here's the recommended version for that platform
  35     - Here are instructions for how to use the [[OpenAFS]] shipped with it
  36     - Here's the source
  37     - Here are distribution packages
  38     - Here are binary Transarc-style packages
  39   - Here are the release notes.
  40   - Here are older versions or other versions that may be appropriate in particular situations with their release notes.
  41 - What does [[OpenAFS]] look like when it's running at my site? How does it fit in with the rest of what I'm doing?
  42   - What is AFS good at?
  43   - What is AFS not good at?
  44   - How are those problems going to be fixed, if they are?
  45   - Where is AFS going in the medium and long term?
  46 - What else do I need?
  47   - Kerberos
  48   - Storage hardware and file system requirements
  49 - Where's the documentation?
  50   - Installation
  51   - Administrator's guide
  52   - Command reference manual
  53 - Where can I get help?
  54   - Bug tracker
  55   - Mailing list archives
  56   - Mailing list subscription
  57 - Where can I buy help?
  58 - How can I help?
  59   - Donations
  60   - Link to the site for managers as noted below
  61 - What's happening?
  62   - [[OpenAFS]] newsletter
  63   - Gatekeeper reports
  64   - Workshop conference papers
  65
  66 ## <a name="For managers:"></a> For managers:
  67
  68 - What is AFS as a strategic file system choice?
  69   - How does it relate to other file systems?
  70   - What features does it have that are interesting, at a high level?
  71   - How can I be confident I can rely on it?
  72   - How does it integrate with the rest of my technical strategy?
  73 - Is AFS supported?
  74   - Where can I get support?
  75   - How active is the community?
  76   - What is the funding model? How does work get done?
  77   - If I need something specific done, how can I get that to happen?
  78 - Who is using AFS?
  79   - Success stories
  80 - What is AFS's future direction?
  81   - Development roadmap
  82   - Estimates of major projects
  83   - Projects in search of funding
  84 - What progress is being made towards those goals?
  85   - [[OpenAFS]] newsletter
  86   - Gatekeeper reports
  87   - Workshop conference papers
  88   - High-level release notes
  89 - What is the project governance?
  90   - AFS Gatekeepers and Elders
  91   - History of the project
  92
  93 ## <a name="For Developers"></a> For Developers
  94
  95 - How do I g\ 1et started helping with AFS?
  96   - Where is the source?
  97   - How do I get a CVS checkout?
  98     - What does the revision management system look like?
  99     - What do the CVS branches look like?
 100     - How do I find deltas and patches?
 101   - Where are the snapshots of the current development?
 102   - Where do I talk about what I'm doing?
 103     - Develoment mailing lists
 104 - What needs to be done? \* Bug tracker \* Project list and development roadmap \* Beginner project list \* Documentation to-do lists
 105 - What are the requirements for contribution? \* Coding style \* Documentation style \* Review and approval process, role of gatekeepers
 106
 107 -- Warren Yenson - 02 Aug 2007