Start presentation

Slide 1: GSI Wiki - a collaborative documentation tool

  • Why?
  • Wiki, what's that?
  • Twiki
  • GSI specific installation
  • Enhanced features
  • Roadmap

Slide 2: Wiki? - Why?

2003: GSI linux farm documentation incomplete

Dream the IT paradise: automatic AI ... documentation system

MY documentation, 1st attempt: using hand-crafted HTML pages:
  • Different tools for read and write; no ubiquitous write access.
  • Lousy link maintenance.
  • Collaborative? Read access for the whole team, write access only for me.

  • Too static!
    • Most of the content is always outdated.

  • Central GSI CMS did not meet the requirements ...

Slide 3: Wiki? - What's that?

---++ 2nd level heading

2nd level heading

*Bold*</code Bold
| 1 |  2  |  2 |
| 4 |  5  |  6 |

2 2 2
4 5 6

  • easy
  • open
  • incremental
  • organic

  • chaotic?

Slide 4: Wiki - Is it working?

Slide 5: Wiki! - Which?

200+ OpenSource implementations of a Wiki: MediaWiki
The Wikipedia engine, PHP + MySql, focussed on the features needed for Wikipedia. TikiWiki
Emerged to an all inclusive CMS (Photo galleries, WebMail etc.) MoinMoin
A popular Python Wiki KWiki
Simple Perl implementation with limited features UseModWiki
Another Perl Wiki EclipseWiki
Personal Wiki as a Plugin for Eclipse IDE jotspot
Polished commercial Wiki (beta) with WYSIWYG and Email-Gateway

Slide 6: TWiki - Why?

TWiki: A Wiki focussed on cooperate intranets

Slide 7: Advanced features

  • TWiki.Macros for dynamic content: %SEARCH{"text"}%, %TOC%, ...
  • Templates define topic patterns
  • Meta data may be added to topics using forms

Shortcuts for external URLs
GSI Oracle device database, manpages, Debian packages, Debian Bugs, Wikipedia, ...

for pretty printing of source code

draw diagrams using a java applet
renders embedded LaTeX formulas

Slide 8: Advanced features

add calculations to TWiki tables
Render charts from data in TWiki tables

Add content skipping Edit MOVED TO... Preview MOVED TO... Save cycle
run TWiki as a bulletin board

turns a topic into a HTML presentation

turns topics into PDF

Slide 9: TWiki weaknesses

It's a geek tool

File system backend and complex rendering engine (variable expansion, ...)

Webs should not grow to large?

No clear cut between data and code complicates upgrade

Slide 10: GSI Wiki, deployed since Nov. 2003

Slide 11: Current GSI Wiki status

  • Unique position as documentation tool for the GSI Linux team
    • Knowledge base
    • Installation log
    • Hardware Database
    • Meeting minutes
    • Trouble ticket system
    • Group calendar

  • Used all over the IT department:
    All OS's, Oracle, Operating, Security, Grid, Controls

  • Adopted by the experiments: Hades, CBM, ...

Slide 12: TWiki management practices at GSI

  • Read access == write access

  • Many small groups
    • Normally a one-to-one mapping of groups to webs
    • Every member of a group can add new members

  • Daily backup on filesystem level (TSM)

  • In the long-term an editor-in-chief has to keep the stuff together?!

  • Evolution from free form content to TWiki applications representing workflows

Slide 13: Roadmap

  • Migration to new server, upgrade to the current release
    • Mainly usability + bugfixes

  • Virtual Wikis
    • Provide collaborations with their own distinct wiki space
    • Share same codebase, but distinct data

  • Enhance usability
    • Smarter update notifications (Email, Instant Messaging?, RSS)
    • Data import/export (HTML, PDF, MS Office)
    • WYSIWYG editor
    • Search index in addition to built-in grep

Slide 14: Roadmap

  • Increase performance
    • Develop a benchmark procedure
    • Evaluation of CGI accelerators, esp. mod_perl
    • Evaluation of cache addons

  • Availabilty, Clustering, Content export

  • Advanced TWiki applications:
    • Better utilization of meta data and forms
    • IT department announcements (walls)
    • Portal

  • Perform GSI internal wiki training

Presentation based on SlideShowPlugin; template used: ChristosSlideTemplate.

This topic is write-protected:

I'd appreciate feedback!

More information

-- ChristopherHuhn - May 2005
Topic revision: r14 - 2016-01-18, ChristopherHuhn - This page was cached on 2020-12-03 - 20:15.

This site is powered by FoswikiCopyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding GSI Wiki? Send feedback | Imprint (german) | Privacy Policy (german)