WikiStyleGuide

Editing Pages    (1II)

• If you see a typo, fix it!    (1IJ)

• When annotating a Wiki page, edit the page, add your comment, and sign it with two dashes followed by your Wiki name a slash and then a date (or a date/time stamp), all in a pair of parenthesis.. For example, "See the end of this suggestion. (--JaneDoe / 2004.08.15 20:18 PST)"    (1IK)

Link Naming Conventions    (1IL)

• Wiki pages related to major categories or subjects should best be prefixed accordingly, e.g. "UblOntologyRepository?", "UblOntologyLanguage?".    (1IM)

• This wiki supports one level of sub-pages (which can be invoked by placing a slash before the WikiWord of the sub-page.) Please use sub-pages, whenever there are possibilities the the same WikiWord identified pages may cause ambiguity when placed at the top level.    (1IN)
• for example, if the community runs multiple projects, and each project will run their own meetings and conferencd call schdeule, then it would be prudent to put, say, the meeting-calling wiki pages as sub-pages to each project.    (1IO)

• When specifying dates or date/times, please express them in a format in the order of the significance of the elements (like yyyy.mm.dd_hh:mm). For example:    (1IP)
• "notes taken by ppy / 2004.08.15 20:18 PST"    (1IQ)
• ConferenceCall_2004_08_15?    (1IR)

Accessibility Considerations    (1IS)

Compliance with Section 508 (of the August 1998 amendment of the U.S. Rehabilitation Act) is required for all US federal government CWE sites, and highly recommended for all other sites. Users (which will be the content developers) should review the ITI VPAT - Best Practices for more details, and to make sure their work meets with requirement.    (1IT)

When users author content that involve non-text elements to convey information, like color pallettes, images & graphics, multimedia presentation, image maps, tables, frames, and when making use of scripts, plug-ins, applets, forms and/or timed responses, they should take responsibility to ensure section 508 compliance, if it is so required. Section 1194.22 - Web-based Internet Information and Applications of the Section 508 VPAT should be referenced.    (1IU)

Wiki pages should generally have no problem with Seciton 508 compliance as the pages are essentially text based. In the case of images, which will be displayed whenever a compatible image element (e.g. a link to a png, gif or jpg file) shows up within the body of the page. To ensure compliance, users should properly caption such linked image elements. For example:    (1IV)

• Picture of the CWE system being demonstrated.    (1IW)

Maintained Pages    (1IX)

While part of the power of wiki's is that anyone who can read a page can also write to it, there are circumstances, when the editing work is better done by one (or a small number of) individuals. If, for some reason, a person is to take full responsibility in maintaining a particular page, please make sure one clearly states that as part of the footer. Include at least the following information:    (1IY)

• This page is maintained by "Your Name"    (1IZ)
• Page last updated    (1J0)
• Describe your desired content update instructions, like"    (1J1)
• please make sure any additions and comments are properly traceable to an author I can reach via e-mail, or    (1J2)
• please email the page maintainer all changes, he/she will post it to this wiki page for you, ... etc.    (1J3)

History Section    (1J4)

There will be times when mailing list discussions lead to important changes that either directly or indirectly affect the Wiki. For example, we may discuss a new approach. Once we reach a decision, we would have to make a major update to a particular Wiki page. When this happens, it's good practice to create a History section on that page, and include a link to the relevant discussion (at the discussion forum archives.) That way, we capture why things are the way they are.    (1J5)