Lombardi Wikis - a CenTex DITA UG panel presentation

Loading...

Flash Player 9 (or above) is needed to view presentations.
We have detected that you do not have it on your computer. To install it, go here.

0 comments

Post a comment

    Post a comment
    Embed Video
    Edit your comment Cancel

    3 Favorites

    Lombardi Wikis - a CenTex DITA UG panel presentation - Presentation Transcript

    1. Lombardi Wikis A model for collaborative information development (with DITA XML in the mix)
    2. What are Lombardi Wikis?
      • Documentation Wiki and Community Wiki - different use cases, integrated user experience
      • Documentation source in DITA, output to wiki
      • A framework for collaborative information development
    3. Outline
      • Strategies and tactics
      • System demo
      • Observations
      • Discussion
      • Strategies and tactics
    4. Early considerations
      • What is the high-level vision?
      • How should the system work?
      • What processes need to be in place to support the system?
      • What are the key components?
      • Who are the key resources?
      • How to keep stakeholders and collaborators engaged?
    5. Project progression
      • Identify business goals
      • Validate goals with the target users
      • Develop and prioritize use cases
      • Define the product and process requirements
      • Define the resources and milestones
      • Implement and test
      • Go live with pilot audience
      • Implement enhancements and bug fixes
      • Go live
      • Measure and maintain (iterative)
    6. Business goals
      • Help customers and partners scale by providing rich user assistance
      • Make helpful information easier to find – fewer support calls, happier customers
      • Provide a user experience that inspires users to contribute to the community
      • Provide a way for users to network and discuss designs and best practices with experts and users like themselves
      • Increase the productivity of customers, partners, and employees
    7. Problems to solve Internal pains Customer pains No way to share “non-warranted” knowledge (samples, tips and tricks) with the community No view into “what’s new” Capturing feedback, questions, and discussions about content is difficult Documentation updates not immediately available - tied to product releases Promotion of new and improved content is difficult Lifecycle management issues – stale information is difficult to discover Reviews are time and resource intensive, vulnerable to quality problems Deep knowledge exists in the product ecosystem but is difficult to tap into
    8. Use cases
      • Find out what's new*
      • Search for specific information*
      • Share knowledge*
      • Get notified of updates*
      • Call out nuggets of information (e.g. rate, vote, favorites)
      • Find something to play with
      • Personalize the experience
      • Ask a question
      • Rant and/or rave
      • Report a problem
      • Talk about myself
      • * Identified as highest priority
      • System demo
    9. Documentation Wiki
    10. Community Wiki
    11. Space architecture Access point (hub space) Space Deliverable (= ditamap scope)
    12. System architecture
      • DITA XML source in SCMS
      • DITA to Confluence export plugin
        • 100% repeatable publishing routine using Java + XSLT
      • Enterprise Wiki (Confluence)
      • Database (SQL Server 2000)
      • Integrations:
        • LDAP
        • SSO
        • Eclipse RCP and Web applications (dynamic Help content directly from the wiki)
    13. Implementation considerations
      • Ditaval and conref
        • Poses major challenges due to unique page ID constraints
        • Best practice: use what the target platform provides where you can – for example, {multi-excerpt}, {include-page} macros that extend the core engine – customize as needed.
      • Navigation
        • Build custom bits to create proper navigation (alphabetical ordering can really corrupt content usability). Add sorting metadata to each page during export, have the engine use the metadata to render a dynamic TOC.
        • Plugin conflicts across versions complicate upgrade scenarios. Plan for upgrade scenarios, especially when customizing plugins. Upgrade scenarios include both server upgrades and individual plugin/macro upgrades.
    14. Conref on the wiki - reusable content
    15. Conref on the wiki – reused content
      • Observations
    16. Problems solved After Before Contribute content, link to and from “warranted” content, tag No way to share “non-warranted” knowledge with the community Detailed comparison view with list of recent updates and version rollback No view into “what’s new” Comment, rate, tag, favorite Interactions with the information are cumbersome to conduct Automated and ad-hoc content updates from DITA XML source Documentation updates not immediately available
    17. Road map Major features Milestone Date January 2008 July 2007 March 2007 April 2005
      • DITA to wiki export (limited)
      • Space architecture for docs and community
      • Hyperlinked TOC pages from ditamaps
      Alpha
      • Support for ditaval and conref
      • Integrated search across other knowledge portals
      GA Version 1.5
      • SSO with other knowledge portals
      • Integrated with product user interface
      GA Version 1
      • Dynamic TOCs from ditamaps
      Beta
    18. Process
      • Info Dev responds to community updates by manually incorporating revisions into DITA source and then republishing
      • Info Dev replies to the originating comments to acknowledge contributions (and track change)
      • Info Dev helps channel knowledge from other forums to the wiki
      • Info Dev contributes community articles
      • Info Dev maintains UI definitions and system files in source control, where changes can be tracked
    19. Engagement methods
      • Special content
      • Themed content drives
      • Daily engagement with audience - “tending and mending”
      • Quarterly/opportunistic promo emails to users
    20. Collaboration methods
      • Delineation of “warranted” versus “non-warranted” information
        • Brokered collaboration model for “warranted” information assets (Documentation Wiki)
        • Cohesive collaboration model for “non-warranted” information assets (Community Wiki)
      • “Core contributors” versus “trusted contributors”
      • Reference: MIT Sloan Management Review, Fall 2007, Vol. 29: “Breakthroughs and the ‘Long Tail of Innovation’”; L. Fleming
    21. Promotion methods
      • Host Webex sessions regularly to increase adoption and get feedback
      • Link to the wiki from Installer (desktop shortcut, last Installer page)
      • Link to the wiki from the product (e.g. Help menu)
      • Wiki pages as dynamic Help
      • Wiki pages as context-sensitive Help
      • Reply to questions on other forums (e.g. discussion groups, email) with links to the wiki
      • Promo emails (to coincide with new features, new and improved content)
    22. Wikipatterns.com
      • Not anti-patterns for us:
        • Empty Pages (use: bubble up the list of empty pages to the home page and ask people to contribute)
        • Registration Required (use: access is restricted to the company user registry - no registration required and no public signup available)
    23. Thank you!
      • Questions? Feedback?
      • [email_address]
      Blueprint it. The easiest way to get started with BPM is now available! www.lombardi.com/blueprint

    + lisa.dyerlisa.dyer, 2 years ago

    custom

    3304 views, 3 favs, 14 embeds more stats

    Lisa Dyer's presentation at the CTDUG panel on the more

    More info about this document

    © All Rights Reserved

    Go to text version

    • Total Views 3304
      • 2827 on SlideShare
      • 477 from embeds
    • Comments 0
    • Favorites 3
    • Downloads 0
    Most viewed embeds
    • 314 views on http://blogs.atlassian.com
    • 69 views on http://www.ikiw.org
    • 53 views on http://justwriteclick.com
    • 18 views on http://blog.kapit.fr
    • 7 views on http://www.wikisolutions.biz

    more

    All embeds
    • 314 views on http://blogs.atlassian.com
    • 69 views on http://www.ikiw.org
    • 53 views on http://justwriteclick.com
    • 18 views on http://blog.kapit.fr
    • 7 views on http://www.wikisolutions.biz
    • 5 views on http://doc2wiki.wik.is
    • 3 views on http://static.slidesharecdn.com
    • 2 views on http://www.web2entreprise.fr
    • 1 views on http://justwriteclick.com:80
    • 1 views on http://dev.kapit.fr:8080
    • 1 views on http://wiki.uiowa.edu
    • 1 views on http://qualif.kapit.fr:880
    • 1 views on http://www.newsgator.com
    • 1 views on http://w2e.kapit.fr

    less

    Flagged as inappropriate Flag as inappropriate
    Flag as inappropriate

    Select your reason for flagging this presentation as inappropriate. If needed, use the feedback form to let us know more details.

    Cancel
    File a copyright complaint
    Having problems? Go to our helpdesk?

    Categories