From OntologPSMW

Jump to: navigation, search
[ ]

The flavor of wiki we are employing here is called [[PurpleWiki]]. It is an derivative of [[UseModWiki]] with the additional support for PurpleNumbers.     (1)

Before editing or making contributions, please make sure you are familiar with the applicable IPR Policy and Membership policies of this community. The co-conveners reserve the right to relocate or remove such material from within this wiki (or anywhere on the CWE) if it is deemed to be in breach of such policies.     (2)

Contents

Getting Started with this Wiki     (3)

The WikiHomePage, a link of which can be found at the upper left corner of any wiki page, would generally be the first place to go. Well designed wiki's should provide further links to appropriate content from that page.     (3A)

Viewing of wiki content can be done with almost any web browser (no password needed for "open" wiki's; username/password will be needed for "community only" wiki's).     (3B)

To write-to (edit content of) the wiki, one will need to login (see: upper right corner), or create an account* if you have not already done so, with a "WikiWord" styled user name for yourself (like "JaneDoe" or "[[AbrahamLincoln]]") before you proceed with a wiki authoring/editing session. We also recommend the use of a password (even if it's simple) so that your identity does not get spoofed too easily. Text formatting rules for this flavor of wiki can be found at the TextFormattingRules page. For other guidelines to working with this Wiki, please read our WikiStyleGuide and WikiProcessGuide. First time users could read more about the WikiWikiWeb and then play in the SandBox.     (3C)

[*Accessability considerations: the "create account" process employs a test mechanism to prevent spambots from acessing the edit mode; users who are vision-challenged should contact the WikiAdmin by e-mail so that authentication credentials may be created by the administrator on their behalf and sent to them.]     (3D)

Editing of any wiki page can be done (after one has logged in) by loading that page on your browser, and then click on the "Edit text of this page" at the lower left corner of the page. Do your edits in the editing dialog box, then click on the "Save" button to update the page. Optionally, one may click on the "Preview" button to see how the new edits look like, or make an entry to "Summarize changes" to help you remember what that edit session entailed.     (3E)

Purple Numbers     (4)

PurpleNumbers are a rather unique and very useful feature supported by this wiki and the CWE (collaborative work environment). Please read up on it at: PurpleNumbers     (4A)

Check [[RecentChanges]] Regularly     (5)

It's good practice to click on [[RecentChanges|RecentChanges]] regularly, to see what's changed, and possibly identify new avenues to which you can contribute. [[RecentChanges|RecentChanges]] links are available at the top and bottom of every wiki page.     (5A)

Wiki Page Index     (6)

Also at the upper left corner (alongside WikiHomePage and RecentChanges) is a link to the Page Index. The provide an alphabetized index of all pages that are in this wiki, and, hence, provide a site-map of the content of this wiki workspace. Make a note of this important resource.     (6A)

Editing Open vs. Maintained Pages     (7)

Editing of content is generally open to any person in the community. Proper netiquette applies, as usual.     (7A)

Generally, everyone is welcomed to make edits. Please refer to styles and conventions for this community at the WikiStyleGuide page. However, if a page is marked as a "Maintained Page", one should always refer updates and changes to the "owner" of that particular page.     (7B)

Only one person can be editing a page at any one time. If there is a conflict (for example, someone actually updated the page while you had it open to add your own content), the system will indicate that. Under that situation, one may want to copy your new additions and changes (and set it aside, e.g. onto your clipboard or a tmp file), close the existing editing session and start a new one, and then add those new additions or changes in.     (7C)

Community Process     (8)

Process will be discussed and adopted among the "active" [ontolog] community members from time to time. "Observers" will not have voting rights to the establishment of the community process. (ref. Sep-02 terms of reference)        (8A)

in the absence of [ontolog] community established process, our process will default to the current OASIS TC Process - see: http://www.oasis-open.org/committees/process.php (ref. Sep-02 terms of reference)        (8B)

  • the start and termination of an ontolog project or subproject should default to the OASIS TC & SC process (where Ontolog "projects" processes will map to OASIS "TC" processes).        (8C)
  • in essence, a new project needs to be supported by at least 3 members, have a project charter or mission statement, a kick-off conference call (or meeting) and a project home page, to get officially launched.        (8D)

System Support     (9)

If you run into a problem, you can contact the WikiAdmin. .. or, feel free to ask anyone in the community who are more familiar with the system and the process -- this is what collaboration is all about.     (9A)