Doing DITA in the Open Source CMS  Drupal Kristof Van Tomme, Pronovix CMS/DITA N-America,  April 4-6, 2011, Baltimore, Mar...
Kristof Van Tomme Belgian Bio-engineer Pronovix Drupal architect Entrepreneur PM of the Drupal Association Hungarian conne...
More than technology Open Source Open Innovation Distributions-SAAS Structured docs Multi-format Training DITA Drupal Tech...
What is drupal?
Drupal sites you might know
Drupal is really good in <ul><li>Breaking vendor lock-in
Communities
Cutting edge technology
Open innovation
Collaborative development
Empowering self-learning individuals </li></ul>
Drupal is really good in <ul><li>Breaking vendor lock-in
Communities
Cutting edge technology
Open innovation
Collaborative development
Empowering self-learning individuals </li></ul>OPEN
Drupal is a platform <ul><li>Open source (GPL)
Drupal core
Modules
Features (apps)
Themes
Distributions </li></ul>Illustration by developmentseed.org when introducing the features module
One platform to rule them all <ul><li>Drupal has a fast growing number of distributions </li><ul><li>Intranets (Open Atrium)
Collaborative market intelligence (Managing News)
Customer community platform (Drupal Commons)
Governments (Open Public)
Publishing companies (Open Publish)
Recruitment (e-recruiter)
Software as a Service (Aegir + any of the above)
... </li></ul></ul>
More than technology Open Source Open Innovation Distributions-SAAS Structured docs Multi-format Training DITA Drupal Tech...
Drupal is a grassroots community “ Come for the code, stay for the community
But Drupal is also <ul><li>A fast maturing software industry
A vast network of service providers
A fast expanding library of handbooks
A network of trainers
Used in the biggest  enterprise deployments
Venture backed professional support companies </li></ul>
More than technology Open Source Open Innovation Distributions-SAAS Structured docs Multi-format Training DITA Drupal Tech...
Drupal's own Documentation
The good <ul><li>Community
A lot of pretty good documentation
Organic adaptive documentation structure </li><ul><li>Drupal.org docs
API.d.o
help in drupal core
issue queue
groups.drupal.org
blogs </li></ul></ul>
The bad  <ul><li>Very few regularly contribute to the official docs
No reuse between documentation types
Documentation is split between resources
Upcoming SlideShare
Loading in …5
×

DITA in the Open Source CMS Drupal - Baltimore 2011

4,820 views
4,625 views

Published on

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,820
On SlideShare
0
From Embeds
0
Number of Embeds
631
Actions
Shares
0
Downloads
44
Comments
2
Likes
2
Embeds 0
No embeds

No notes for slide

DITA in the Open Source CMS Drupal - Baltimore 2011

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

×