Your SlideShare is downloading. ×
0
DITA in the Open Source CMS Drupal - Baltimore 2011
DITA in the Open Source CMS Drupal - Baltimore 2011
DITA in the Open Source CMS Drupal - Baltimore 2011
DITA in the Open Source CMS Drupal - Baltimore 2011
DITA in the Open Source CMS Drupal - Baltimore 2011
DITA in the Open Source CMS Drupal - Baltimore 2011
DITA in the Open Source CMS Drupal - Baltimore 2011
DITA in the Open Source CMS Drupal - Baltimore 2011
DITA in the Open Source CMS Drupal - Baltimore 2011
DITA in the Open Source CMS Drupal - Baltimore 2011
DITA in the Open Source CMS Drupal - Baltimore 2011
DITA in the Open Source CMS Drupal - Baltimore 2011
DITA in the Open Source CMS Drupal - Baltimore 2011
DITA in the Open Source CMS Drupal - Baltimore 2011
DITA in the Open Source CMS Drupal - Baltimore 2011
DITA in the Open Source CMS Drupal - Baltimore 2011
DITA in the Open Source CMS Drupal - Baltimore 2011
DITA in the Open Source CMS Drupal - Baltimore 2011
DITA in the Open Source CMS Drupal - Baltimore 2011
DITA in the Open Source CMS Drupal - Baltimore 2011
DITA in the Open Source CMS Drupal - Baltimore 2011
DITA in the Open Source CMS Drupal - Baltimore 2011
DITA in the Open Source CMS Drupal - Baltimore 2011
DITA in the Open Source CMS Drupal - Baltimore 2011
DITA in the Open Source CMS Drupal - Baltimore 2011
DITA in the Open Source CMS Drupal - Baltimore 2011
DITA in the Open Source CMS Drupal - Baltimore 2011
DITA in the Open Source CMS Drupal - Baltimore 2011
DITA in the Open Source CMS Drupal - Baltimore 2011
DITA in the Open Source CMS Drupal - Baltimore 2011
DITA in the Open Source CMS Drupal - Baltimore 2011
DITA in the Open Source CMS Drupal - Baltimore 2011
DITA in the Open Source CMS Drupal - Baltimore 2011
DITA in the Open Source CMS Drupal - Baltimore 2011
DITA in the Open Source CMS Drupal - Baltimore 2011
DITA in the Open Source CMS Drupal - Baltimore 2011
DITA in the Open Source CMS Drupal - Baltimore 2011
DITA in the Open Source CMS Drupal - Baltimore 2011
DITA in the Open Source CMS Drupal - Baltimore 2011
DITA in the Open Source CMS Drupal - Baltimore 2011
DITA in the Open Source CMS Drupal - Baltimore 2011
DITA in the Open Source CMS Drupal - Baltimore 2011
DITA in the Open Source CMS Drupal - Baltimore 2011
DITA in the Open Source CMS Drupal - Baltimore 2011
DITA in the Open Source CMS Drupal - Baltimore 2011
DITA in the Open Source CMS Drupal - Baltimore 2011
DITA in the Open Source CMS Drupal - Baltimore 2011
DITA in the Open Source CMS Drupal - Baltimore 2011
DITA in the Open Source CMS Drupal - Baltimore 2011
DITA in the Open Source CMS Drupal - Baltimore 2011
DITA in the Open Source CMS Drupal - Baltimore 2011
DITA in the Open Source CMS Drupal - Baltimore 2011
Upcoming SlideShare
Loading in...5
×

Thanks for flagging this SlideShare!

Oops! An error has occurred.

×
Saving this for later? Get the SlideShare app to save on your phone or tablet. Read anywhere, anytime – even offline.
Text the download link to your phone
Standard text messaging rates apply

DITA in the Open Source CMS Drupal - Baltimore 2011

4,247

Published on

Recently we published an alpha version of the DITA module for Drupal, …

Recently we published an alpha version of the DITA module for Drupal,
a community driven Open Source CMS that powers 1% of the Internet. The
module contains the tools for uploading topics individually or in
bulk, it let's you author DITA topics in forms and it has a Graphical
User Interface that let's you create mindmaps that can be used as DITA
maps. The DITA maps so created, together with their referenced topics
can also be exported using the DITA Open Toolkit integration. In this
talk you'll get an introduction to Drupal and the DITA module and
you'll learn how we want to use it to help our community write better,
more reusable documentation.

Published in: Technology
2 Comments
2 Likes
Statistics
Notes
No Downloads
Views
Total Views
4,247
On Slideshare
0
From Embeds
0
Number of Embeds
4
Actions
Shares
0
Downloads
42
Comments
2
Likes
2
Embeds 0
No embeds

Report content
Flagged as inappropriate Flag as inappropriate
Flag as inappropriate

Select your reason for flagging this presentation as inappropriate.

Cancel
No notes for slide

Transcript

  • 1. Doing DITA in the Open Source CMS Drupal Kristof Van Tomme, Pronovix CMS/DITA N-America, April 4-6, 2011, Baltimore, Maryland
  • 2. Kristof Van Tomme Belgian Bio-engineer Pronovix Drupal architect Entrepreneur PM of the Drupal Association Hungarian connection Techno-optimist Biotech Drupal evangelist Husband and Father Strategist CEO
  • 3. More than technology Open Source Open Innovation Distributions-SAAS Structured docs Multi-format Training DITA Drupal Technology Community Craftsmanship DIY users Enterprise Consultants Documentation writers Vendors ?
  • 4. What is drupal?
  • 5. Drupal sites you might know
  • 6. Drupal is really good in
    • Breaking vendor lock-in
    • 7. Communities
    • 8. Cutting edge technology
    • 9. Open innovation
    • 10. Collaborative development
    • 11. Empowering self-learning individuals
  • 12. Drupal is really good in
    • Breaking vendor lock-in
    • 13. Communities
    • 14. Cutting edge technology
    • 15. Open innovation
    • 16. Collaborative development
    • 17. Empowering self-learning individuals
    OPEN
  • 18. Drupal is a platform Illustration by developmentseed.org when introducing the features module
  • 24. One platform to rule them all
    • Drupal has a fast growing number of distributions
      • Intranets (Open Atrium)
      • 25. Collaborative market intelligence (Managing News)
      • 26. Customer community platform (Drupal Commons)
      • 27. Governments (Open Public)
      • 28. Publishing companies (Open Publish)
      • 29. Recruitment (e-recruiter)
      • 30. Software as a Service (Aegir + any of the above)
      • 31. ...
  • 32. More than technology Open Source Open Innovation Distributions-SAAS Structured docs Multi-format Training DITA Drupal Technology Community Craftsmanship DIY users Enterprise Consultants Documentation writers Vendors ?
  • 33. Drupal is a grassroots community “ Come for the code, stay for the community
  • 34. But Drupal is also
    • A fast maturing software industry
    • 35. A vast network of service providers
    • 36. A fast expanding library of handbooks
    • 37. A network of trainers
    • 38. Used in the biggest enterprise deployments
    • 39. Venture backed professional support companies
  • 40. More than technology Open Source Open Innovation Distributions-SAAS Structured docs Multi-format Training DITA Drupal Technology Community Craftsmanship DIY users Enterprise Consultants Documentation writers Vendors ?
  • 41. Drupal's own Documentation
  • 42. The good
    • Community
    • 43. A lot of pretty good documentation
    • 44. Organic adaptive documentation structure
  • 50. The bad
    • Very few regularly contribute to the official docs
    • 51. No reuse between documentation types
    • 52. Documentation is split between resources
    • 53. Hard to enforce standards
    • 54. A given documentation page is written for a single audience type
    • 55. Issues with version specific documentation
  • 56. More than technology Open Source Open Innovation Distributions-SAAS Structured docs Multi-format Training DITA Drupal Technology Community Craftsmanship DIY users Enterprise Consultants Documentation writers Vendors ?
  • 57. Combining Drupal & DITA
  • 58. What Drupal brings to DITA
    • An open source option
    • 59. Interoperability
    • 60. Extensibility
    • 61. Human friendly metadata handling
    • 62. Game dynamics (user points)
    • 63. social graph (Facebook integration)
    • 64. Community tools (those web 2.0 things)
    • 65. RDFa (those web 3.0 things)
  • 66. What Drupal brings to DITA
    • An open source option
    • 67. Interoperability
    • 68. Extensibility
    • 69. Human friendly metadata handling
    • 70. Game dynamics (user points)
    • 71. social graph (Facebook integration)
    • 72. Community tools (those web 2.0 things)
    • 73. RDFa (those web 3.0 things)
    CUTTING EDGE
  • 74. What Drupal needs from DITA
    • Best practices for single source documentation
    • Ecosystem of documentation tools & services
    • 78. More documentation writers
  • 79. More than technology Open Source Open Innovation Distributions-SAAS Structured docs Multi-format Training DITA Drupal Technology Community Craftsmanship DIY users Enterprise Consultants Documentation writers Vendors ?
  • 80. All that for a community of > ½ Million users
  • 81. The problem is...
  • 82. Mere mortals don't write XML
  • 83. Drupal had/has a similar problem
  • 84. Crossing the chasm http://www.exampler.com/testing-com/writings/reviews/moore-chasm.html DRUPAL
  • 85. The long tail of documentation http://blogs.idc.com/ie/?p=53
  • 86. The long tail of documentation HOW DO DITA x 5?
  • 87. How do DITA x 5 http://www.archive.org/details/drupalconchi_day3_keynote_jared_spool $ Need a cheap step in solution Usability
  • 88. More than technology Open Source Open Innovation Distributions-SAAS Structured docs Multi-format Training DITA Drupal Technology Community Craftsmanship DIY users Enterprise Consultants Documentation writers Vendors ?
  • 89. Words are silver, code is gold
  • 90. Drupal DITA forms
    • Use friendly flexible UI to create documentation forms
    • 91. Store in Drupal, export in DITA
    • 92. Currently implemented for tasks and concepts
  • 93. Drupal DITA forms
  • 94. Drupal DITA form builder (CCK)
  • 95. Import existing documentation
    • Upload individual files
    • 96. Import folders
      • Automatic checkout from a version controlled documentation repository
      • 97. Drupal checks for updates
    • Other import options can be tailored for specific use cases to plug into existing processes
  • 98. Folder importer
  • 99. User driven assembly and export
    • Bookmark relevant documentation topics
    • 100. Create a new DITA map in the GUI
    • 101. Export the map and the topics it contains
  • 102. Ditamaps as mindmaps
  • 103. Add content with Views queries
  • 104. Ditamaps as mindmaps
  • 105. Export with Open Toolkit
  • 106. You can download this for free at http://drupal.org/project/dita
  • 107. Future Vision DITA in Drupal
    • Metadata integration
    • 108. DITA form to DITA XML Graphical UI
    • 109. Authoring memory
    • 110. Conref library
    • 111. WYSIWYG or markup
    • 112. 1 or more distributions:
      • Documentation distribution
      • 113. DITA distribution
  • 114. A toolbox with 6000+ free modules CC BY-NC-SA 2.0 by libertyandvigilance http://www.flickr.com/photos/10459273@N05/3935251879/sizes/z/in/photostream/ 8800+
  • 115. Our business = help you realize Open Source Open Innovation Distributions-SAAS Structured docs Multi-format Training DITA Drupal Technology Community Craftsmanship DIY users Enterprise Consultants Documentation writers Vendors ?!
  • 116. Future Vision for Drupal Docs
    • Documentation becomes a modular patchable unit, that is used to build project documentation
    • 117. Everyone contributes to documentation
    • 118. A new niche grows in our community for technical writers
    • 119. Projects can be documented from a Fingerprint (XML settings dump)
  • 120. Invitation to join our community
  • 121. Community portal for DITA Open Source Open Innovation Distributions-SAAS Structured docs Multi-format Training DITA Drupal Technology Community Craftsmanship DIY users Enterprise Consultants Documentation writers Vendors ?
  • 122. More than technology Open Source Open Innovation Distributions-SAAS Structured docs Multi-format Training DITA Drupal Technology Community Craftsmanship DIY users Enterprise Consultants Documentation writers Vendors ?
  • 123. Twitter @kvantomme LinkedIn be.linkedin.com/in/kvantomme [email_address]
  • 124. More than technology Open Source Open Innovation Distributions-SAAS Structured docs Multi-format Training DITA Drupal Technology Community Craftsmanship DIY users Enterprise Consultants Documentation writers Vendors ?

×