welcome: please sign in

Diff for "RewriteGoals"

Differences between revisions 7 and 11 (spanning 4 versions)
⇤ ← Revision 7 as of 2007-10-20 18:10:07 →
Size: 1785
Editor: MichaelOlson
Comment: Add style guide sectoin
← Revision 11 as of 2008-07-07 04:28:00 → ⇥
Size: 1513
Editor: localhost
Comment: converted to 1.6 markup
Deletions are marked like this. Additions are marked like this.
Line 3: Line 3:
[[TableOfContents]] <<TableOfContents>>
Line 15: Line 15:
   * Provide more examples on ["DomTool/Examples"] and on MigrationTips    * Provide more examples on [[DomTool/Examples]] and on MigrationTips
Line 21: Line 21:
=== Template ===

Here's a basic template to apply when making new pages and revising old ones.

{{{
Description of page. I.e.: This page describes how to filter your email using
procmail and Exim.

## Every page should have a table of contents
[[TableOfContents]]

Remaining content of page, split into logical sections.
}}}

=== Style ===

It would probably be best to use "you" (second-person) when writing the MemberManual.

The AdminManual (basically just a re-org of NewServerSetup) should be in third-person.		 See StyleGuide.
Line 45: Line 27:
If you want to have charge of a particular page or topic, please indicate this below. If you want to help out with a particular page or topic, please indicate this below.
Line 52: Line 34:
   * Pages need to be deleted -- see RewriteGoals/PagesToDelete
Line 55: Line 35:
We have just started. We're done with the MemberManual, which was the main goal of the rewrite. The next step is to sift through the remaining pages, remove obsolete ones, and save historical ones.

 * RewriteGoals/PagesToDelete: Pages that need to be deleted.
 * RewriteGoals/PagesNeedingLove: Pages that need some attention, but should not be deleted.

This page describes the effort to bring the wiki up-to-date with respect to the new setup.

Contents

  1. Context
  2. Style guide
  3. Personnel
  4. Progress

1. Context

The information on this wiki needs to be made accurate with the current setup (deleuze, mire, abulafia, etc.).

This involves:

  • Updating information on existing pages
  • Deleting pages that have no useful content
  • Make it easy for members to get up-to-speed on migration,

  • Making an HCoop "Member Manual", perhaps by using MemberManual for the start page, with chapters represented as subpages

  • Making a migration FAQ that answers all questions that members are likely to have during migration

2. Style guide

See StyleGuide.

3. Personnel

MichaelOlson is in charge of this effort.

If you want to help out with a particular page or topic, please indicate this below.

Name

Pages / topics

RyanMikulovsky

Parts of Non-technical administrative stuff?

MichaelPotter

Basic account usage

4. Progress

We're done with the MemberManual, which was the main goal of the rewrite. The next step is to sift through the remaining pages, remove obsolete ones, and save historical ones.

RewriteGoals (last edited 2008-07-07 04:28:00 by localhost)