Tool

jhodgdon's picture

7.x-2.x version of API module ready for testing

Neil Drumm (drumm) and I have been working lately on the API module (used to build API documnentation sites like https://api.drupal.org and others). We've made a 7.x-2.x branch of the project, which works quite differently from the 7.x-1.x branch. The major changes are that it uses a different (and external) parsing library for parsing PHP files, and it uses Composer to manage its external library dependencies.

Read more
LeeHunter's picture

Panelists for "Structured Content Authoring" session at Design for Drupal Boston?

One of the important challenges facing the effort to improve Drupal as tech comm tool is getting the right user experience for authors especially when we start adding things like conditional text, single-sourced content and DITA-style mapping.

Read more
wizonesolutions's picture

Tool recommendations for documentation page editing?

I was tweeting @drupaldocs yesterday, which is now leading to me posting here. Observe:

Me: @drupaldocs Can you recommend any tools/browser plugins/etc. for quicker/easier editing of docs? Maybe outliners, and so on? #drupal
@poplarware: @wizonesolutions @drupaldocs I don't know of any... maybe another Docs contributor does -- you could post on our g.d.o group with more info?

So here I am!

Read more
jhodgdon's picture

Call for programmers and site builders to help with docs infrastructure!

If you are an experienced site builder, or a medium-to-experience PHP programmer, the Docs Team needs your help! We have several things that we’d like to get done that will improve the infrastructure for documentation and for contributing to documentation in the Drupal project.

EDIT: I'm marking tasks "taken" if someone has spoken up to do them.
Update Sept 23 - new tasks added!!
Update November 15 - task list edited

Site Builder Tasks

Read more
Itangalo's picture

Documentation Robot: feedback appreciated

I recently got the opportunity to work on an idea that I've had for a few weeks – some kind of automized technical documentation of Drupal sites. It resulted in a rudimentary but working module Documentation Robot, collecting some technical information about the site where it is installed and summarizing it on a page.

It currently collects information about node types (including CCK fields), installed modules/projects, and user roles. In the pipe is also support for documenting views, panels, better CCK field documentation, and a tonne of other ideas I got. I also want to make the collected information re-usable in a number of different formats (for example DITA or creation of book nodes), but that is further off in the future.

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

Doc tool user stories

This page is for gathering user stories for the development of technical communication tools within Drupal.

Read more
Subscribe with RSS Syndicate content