Create a documentation distribution in Drupal that uses the DITA architectureDITA (Darwin Information Typing Architecture) is a modular document architecture that was developed by IBM. DITA content is written as modular topics, as opposed to long "book-oriented" files. Modular topics can be easily reused in other composite documentation maps. We want to make a Drupal DITA distribution that makes it easy to reuse the documentation topics from Drupal.org in site documentation. DITA supports version handling, audience filtering and even platform specific subsections. We've talked with Add1sun from the documentation team and with Gerhard from the infrastructure team and both are interested in having such a system as the new documentation on Drupal.org. A DITA map contains links to topics, organized in the sequence (which may be hierarchical) in which they are intended to appear in finished documents. A DITA map defines the table of contents for deliverables. Relationship tables in DITA maps can also specify which topics link to each other (adapted from Wikipedia). Using DITA maps it's possible to reorganize information as needed. When we're done we'll have upgraded the documentation infrastructure on Drupal.org and we'll have contributed a Drupal distribution for documentation management that makes it possible to do things like:
|
Site fingerprint: a module and service that lets you post and compare configuration dumpsDrupal so far does not yet have a configuration dump module that gives you an object with all the configurations of a site. The site fingerprint module allows you to export all exportables and some additional information like the variables and the names, versions and weights of the module that are enabled on your site through the click of a button. You can either download the fingerprint object or directly upload it to our fingerprint service, which functions like a paste-bin. You can than reference the object when you submit an issue or use it as a "state" backup for future reference. The aggregated statistics of this service will be used to develop some of the other projects described on this site. We want to provide this fingerprint pastebin service at no cost to the community. To pay the bills we are counting on donations from the community. As a reward donors will receive a premium membership that will have advanced features like:
|
Documentation+
The aim of this first fundraising round is to create 2 basic tools that will become the basis for most of our future developments. We've already built a first version of the site fingerprint module which will besides of being a useful bug tracking tool will also generate the statistics needed to work out what are the most important features for different people. The DITA documentation will give us the basic architecture for better collaboration on configuration sets. In it's own right it is a valuable addition to our developers toolsets, but it will also give Drupal documentation the granularity, re-usability and information range that will be the basis for some of the other business tools we plan to build.

