PRONOVIX

Evolving web sites

DITA

DITA single source documentation demo

Pronovix has been working on a functionality set for Drupal that makes it easier to build single sourced documentation platforms. Our work has sufficiently advanced to serve as the basis for bespoke built sites and we are actively looking for product owners or technical writers that would like to build a documentation collaboration site for their communities.

Documentation in DITA in the Open Source CMS Drupal: presentation from CMS/DITA N-America in Baltimore

Last week I attended Content Management Strategies/DITA N-America, afaik the leading conference in the DITA community. The conference with 300 participants reminded me a lot of my first Drupalcon in Brussels, there are some obvious differences (e.g. most attendees are not programmers but technical writers, the food was as good as the food we got on the Drupal Gov Days) but if you look closer you'll see that the DITA community has a sharing culture much like our own.

Drupaldevdays session: Documenting (in) Drupal, the next generation - leveraging DITA, RDFa, fingerprints and mindmaps

This is a presentation that I gave at the Drupal Developer Days, on 6 February 2011. It's meant as an introduction to single sourcing. It contains the results of the documentation questionnaire we ran.

What would the ideal documentation system for a community driven project like Drupal look like?

From the outside Drupal is perceived as a well documented project, and several people choose to work with Drupal because of this. On the inside however, a lot of people complain about the documentation. What's the reason and the meaning of these differences in perception?

Win a Mr-T-shirt: Documentation questionnaire

Help us improve the documentation tools in Drupal and get to own a Mr. Fivestar T-shirt

This weekend at the Drupal Developer Days in Brussels, I'm giving a presentation about documentation systems for/in Drupal. The main focus of the presentation will be different new technologies that we've been working on to improve Drupal's documentation technology stack. We believe that these could revolutionize the way we do documentation for Drupal projects and at the same time open up a new market for our favorite CMS.

To test the relevancy of my recommendations for the community, I've put together a questionnaire of which the results should help us better understand your needs and priorities. To make it even more worth your while, we are giving away Mr T-shirts to people that submit a filled out questionnaire:

  • a t-shirts will be handed out to the first 3 people to complete the questionnaire
  • 3 t-shirts will go to people we'll select at random from participants that filled out the questionnaire and tweeted about it
  • 3 more t-shirts will be given to people we'll select at random from the remaining participants

We won't be shipping the t-shirts, if you win you or a friend will have to come pick them up at BDDD or at Drupalcon Chicago.

TAKE THE SURVEY!.

Technologies for an improved infrastructure for Drupal's documentation

This is a crosspost of the wiki I create at http://groups.drupal.org/node/109119

In February LeeHunter posted his wish list of features for "an awesome technical communication CMS". I've copied his list and processed the comments in the discussion and some of my own, and added our current status implementing these features and ideas of how any missing features could be implemented in the near future.

DITA Integration module is up

We've published the first version of our DITA Integration module wich allows to handle DITA documentations with Drupal. It's still being developed and we would not suggest to use on a live site, but as a proof of concept, it's ready for testing! For now, we have the following features:

Leveraging communities for an improved DITA documentation process in Drupal

video: 

In this video I explain how an organization can use a 3-step architecture to involve all the stakeholders of the production process in the development of DITA documentation. The architecture adds a community portal both upstream and downstream of the documentation team. The upstream and downstream portals can plug into the existing tools and processes of the documentation team through the use of DITA documentation topics and maps.

As a result more people are involved in the process without having to buy additional licenses of (expensive) specialized XML editors and/or CMS's.

Documentation client & server, poorman's DITA and improved export - Drupal-DITA documentation distro progress report 2

video: 

Next video in the DITA documentation progress report series in which I demonstrate the results of the work of my colleagues Denes, Tamas and Kornel.

In this video you'll see:

  • A prototype of the documentation client and server that can be used for centralized documentation similar to how the localization server works.
  • Poorman's DITA: A CCK form with the most important elements from the DITA topics (currently tasks and concepts) that is transformed into valid DITA XML

Using Graphmind and Drush to build and export ditamaps with DITA Open Toolkit - Drupal-DITA documentation distro progress report

video: 

In this video I demonstrate the results of the work of my colleagues Denes and Tamas, who built a first implementation of a Drupal site that takes DITA topics and let's you add them in a mindmap interface to a DITAmap and than export them using the DITA Open Toolkit.

This is a follow up on the blog posts I published a month ago: one with an interface mockup and the other post with a mindmap to ditamap conversion proposal.

Syndicate content