Fix broken directory links
[openafs-wiki.git] / general / 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