DITA

eric_sea's picture

Drupal Dojo Session: DITA Integration module installation tutorial

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

Read more

A DITA documentation distribution for Drupal

Introduction

A couple of weeks ago we launched Modulecraft an awareness & fund-raising project that aims to rally Drupal professionals around a shared effort to create the ultimate toolset for Drupal business. The first fundraising round has as goal the development of a documentation distribution for Drupal that uses a similar approach as the localization server and that enables a distributed/federated documentation architecture for the Drupal project. As a Drupal user you'll be able to get a set of documentation from the drupal.org docs server imported into your own site. You will than be able to edit it and build subsets of the documentation for your own projects. You'll also be able to submit topics that were edited or created by you on your own infrastructure and add them as suggestions to the Drupal documentation server.

The following is a first proposal for the specification of the Documentation system we want to build as part of the modulecraft project. It is by no means complete, and it strongly needs your feedback. This is our first encounter with DITA and our ideas should really be proof checked by technical writers that have extensive experience using DITA. It also contains some proposes a somewhat exotic usage of RDFa, feedback is also very much needed here. In the coming days I'll be adding new sections to the specification here. This is a wiki so be bold! You can add comments either here or at the original posts on the Pronovix blog. I'll be incorporating feedback into this wiki.

Read more
Subscribe with RSS Syndicate content

Drupal Dojo

Group organizers

Group events

Add to calendar

Group notifications

This group offers an RSS feed. Or subscribe to these personalized, sitewide feeds: