Drupal Dojo Session: DITA Integration module installation tutorial

eric_sea's picture
Start: 
2010-11-30 12:30 - 13:30 America/New_York
Event type: 
Online meeting (eg. IRC meeting)

Leader: Denes Lados (mimrock)

The book module is often seen as the documentation in/for Drupal. But it falls short in a couple of areas:
* There is only 1 hierarchy that never really fits all needs
* There are no standards in structuring the information inside a post, so 1 post might actually explain more than 1 topic
* You can only export individual pages or top level chapters with their children, you can't easily export cherry-picked topics (across chapters) into 1 document
* Version management is handled through the forking of the whole documentation

In our last session (http://groups.drupal.org/node/107374#comment-347474) kvantomme explained about single sourcing and DITA (Darwin Information Type Architecture) and how it solves all of the above issues and more.

In this session Denes Lados will explain how to install and use the DITA Integration module.

Register to Attend: https://www1.gotomeeting.com/register/381237985

Comments

Point of

eric_sea's picture

Point of clarification--
While DITA may offer some exciting options for Documentation on Drupal.org, conversations regarding DITA options are only just getting started. There have been no official decisions by the document team leadership regarding DITA implementation of Drupal.org

Those of use working on the Drupal Open Learning Initiative are very excited about the future potential of DITA and we are looking forward to continuing the discussion with those on the Documents Team and in the DITA community.

Yes for DITA!

eDeliberation's picture

I'm a Drupal neophyte trudging up the Drupal learning curve the best I can, trying to absorb existing documentation - have also read a couple Drupal-related books. The upshot is that the Drupal documentation does seem to need to be better structured, organized and in some cases written. In my experience developers don't relish documenting their stuff, and when they do, it is hard for them to abstract their own expertise far enough away to be able to write at the level of those who do not share that same level of expertise.

Having a DITA-based documentation structure would help organize this expertise in a way that woudl be accessible and more standard/professional, and it would help guys like me master this beautiful community-based product more quickly and predictably.

On a final note, I want to express my gratitude and admiration for how the Drupal community works. I have recently emerged from the business, for-profit sector, and this is a discovery and an enlightenment.

DITA Integration

Brayaan_Taior34's picture

DITA Integration module which allows to handle DITA documentations with Drupal. This helps to upload dita tasks/concepts/documents and convert your dita documentations into xhtml or pdf2, or can download them in tar.gz. Create relation tables in the map with Drupal's taxonomy. There are many feature in DITA integration module. If you want any kinds of academic help please contact custom essay writing service