<Insert Picture Here>

An Introduction to RAC Knowledge Wiki

Jarod WangRAC DevelopmentFebruary 20th, 2009

2

Agenda

• What’s a Wiki?• RAC Knowledge Wiki• TWiki Features & Applications• Structure of a TWiki Page• Creating New Pages• Editing Pages• Commonly Used Formatting• More Formatting• Existing RAC-related Pages• Q&A

3

What’s a Wiki?

• “A Wiki is a page or collection of Web pages designed to enable anyone who accesses it to contribute or modify content, using a simplified markup language.“ – Wikipedia, the free encyclopedia

4

RAC Knowledge Wiki

• http://siku.oraclecorp.com/bin/view/Knowledge/RAC• Created in August 2007• Created on internal Siku website, originates from

Chinese characters “ 四库” or “ 思库”• Created in the Knowledge “ 集” category• Uses Perl-based TWiki as wiki software• Serves as an index of all RAC-related wiki pages

created by CDC RAC Development team members

5

TWiki Features & Applications

• Builds on the original wiki concept and adds a number of features that make it very useful in a business environment.

• Pages are fully revision controlled, so a record of every change to every page is kept

• The look-and-feel is highly configurable, through use of templates

• Plug-ins

• A whiteboard • A document repository • A collaborative authoring

environment • A notebook• A chat room • A project management system • A tracking tool• (truth is, we don't really know

its limits!)

6

Structure of a TWiki Page

TWiki pages are usually organized into three parts: • A header • A body • A footer

• The header and the footer are generated by the system

• The body contains the text of the page, as entered by you

• Demo

7

Creating New Pages

• Registration with your email address and WikiName

• Alternative ways to create new page:• Click on the question mark after a WikiWord• Click on “Create New Topic” on the sidebar• Type in the name of the topic in the URL • Any time you try to visit a page that doesn't exist,

TWiki will invite you to create it• Make sure the names of topics are always WikiWord• Demo

8

Editing Pages

• Click the “Edit” link on the upper right corner of a page• You've clicked the edit link, and an edit page has

appeared. But it doesn’t look much like what was on the page before - it's full of strange hieroglyphics!

• The hieroglyphics are what's known as "Twiki Markup" or "formatting"

• They are a really simple way of telling the browser how you want the page to look

• Demo

9

Commonly Used Formatting

• ---+ indicates a heading. Add more +'s for a deeper heading.

• %TOC% will insert a table of contents• A blank line gives a paragraph break• Text in stars *like this* looks like this• Text in underscores _like this_ looks like this• Text in equals signs =like this= looks like this • Bulleted lists use three spaces followed by an asterisk

(*) at the start of the line. The depth of the bullet is given by the number of spaces, in multiples of three

• Demo

10

More Formatting

• Internal and external URL• <verbatim> and </verbatim>• Table• Attachment (up to 1024 KB)• Icons• http://siku.oraclecorp.com/bin/view/TWiki/

TextFormattingRules• Demo

11

Existing RAC-related Pages

• http://siku.oraclecorp.com/bin/view/Knowledge/RAC• http://dbdev.us.oracle.com/• http://globaldc.oracle.com/perl/twiki/view/

RACGuides/WebHome• ShipHomeSaga• IPMI• CTSS• ATM• Workloads• Scripts

12

Feedback, questions, and supplement welcomed

Q&A