1. Organizing information flow: Operations Wiki Gregory J. Marr Operations Specialist Relativistic Heavy Ion Collider, BNL

2. September 24, 2007WAO 20072 Communication within BNL Collider-Accelerator Operations Operations documentation has, mostly, transitioned from paper to web (html, pdf files) Some information flow is well established –Web/database “elog” records for recording shift operations, machine tuning history. –Operations Procedures Manual (OPM) covers radiation, environmental & electrical safety, emergency response, etc.

3. September 24, 2007WAO 20073 Communication within BNL Collider-Accelerator Operations Other web documents serve various purposes –Training modules –Reference documents, troubleshooting guides –Daily/weekly/monthly/yearly updates of information pertinent to current operations

4. September 24, 2007WAO 20074 Motivation Web documents tend to stagnate –Documents orphaned when author moves on –No central oversight to assign updates –Difficult to keep up with information that changes on various timescales –Readers have no avenue for correcting errors they find Haphazard organization of files –Mix of personal and common directories –Little directory structure overall Cross-references, if offered at all, become stale.

5. September 24, 2007WAO 20075 Wiki: a dynamic, collaborative system of documents Most familiar example: WikipediaWikipedia Server-based software uses PHP to render web pages from MySQL database User interfaces via web browser, to read or edit pages (“articles”) –Uses a pared-down form of markup Database retains history of all revisions Full text search of articles included

6. September 24, 2007WAO 20076 Wiki features, continued Organizational tools include: –Categories for grouping articles –Various listings of pages “Namespaces” provide high-level organization in the database –Indices

7. September 24, 2007WAO 20077

8. September 24, 2007WAO 20078

9. September 24, 2007WAO 20079 Advantages Large user community Low-maintenance software Page history, accountability –Anonymous edits are disallowed Easy tools for grouping information in multiple ways Easy navigation and cross-referencing Documents become collaborative efforts, representing a sum of knowledge Dual-purpose training tool –Useful reference for new operators as a glossary, overview of systems & accelerator concepts, etc. –Assigning new operators articles to write encourages learning, fosters interaction with system experts and colleagues

10. September 24, 2007WAO 200710 Disadvantages No WYSIWYG editor (yet) –Learning curve for new users Requires involvement from entire operations group Requires oversight, periodic review –Needs a person to oversee growth and development of the Wiki, encourage use.

11. September 24, 2007WAO 200711 References J. Niedziela, et al., “Dynamic Collaborative Documentation at the Brookhaven National Laboratory Collider-Accelerator”, proceedings of the 2007 Particle Accelerator Conference, Albuquerque, NM, pp. 658-660 (2007).Dynamic Collaborative Documentation at the Brookhaven National Laboratory Collider-Accelerator Required software –MediaWiki.orgMediaWiki.org Wiki source code Documentation, help forums –php.netphp.net php scripting language –mysql.commysql.com MySQL database