A little while back I posted about an idea I was discussing with the rest of the community team about a downloadable advocacy kit that, similar to an SDK for software, provides everything you need to get started spreading the word about Ubuntu. Dubbed the Advocacy Developer Kit (ADK), the idea is that a single .zip file (or package) would contain everything you need to get started, including:

  • Well written, simple, and detailed documentation for joining, creating, and running LoCo Teams, as well as general advocacy, tips, and tricks.
  • A selection of high-quality posters, banners and other materials.
  • Resources for creating new materials.
  • Presentations that can be used for giving an Ubuntu demo / Charm School etc.

This content would make it easier for advocates to get going, instead of navigating the wealth of unorganized content on the wiki and variety of promotional materials. The ADK provides a set of curated content that gets someone up and running quickly.

We will include some resources in the ADK such as banners, posters, presentations, templates and more. The idea is to only pick a few of each category (e.g. just a few posters) for inclusion in the ADK but provide a link to further content on SpreadUbuntu. The analogy here is similar to Ubuntu; in Ubuntu we provide a single high-quality text editor, but we provide simple access to alternatives in the Ubuntu Software Center. We can then decide on the best content in the ADK based on criteria such as general quality, brand guidelines etc.

One of the motivations behind the ADK is to provide a project that our advocacy community can collaborate around. Our theory is that having a branch that people can contribute to will feel worthwhile as a participant, and we can more easily track issues in the ADK with bug tracking, and also support translations of the content (we can provide localized ADKs). We are using the same technical foundation that has gone into the Ubuntu Packaging Guide.

To kick this off I asked Daniel Holbach to create a branch that we can work from, and I spent some time tonight populating it with some initial content. We have lots of awesome content on the wiki, so I started moving it over to the ADK.

Getting The ADK

Very early start to the ADK.

Currently the ADK lives in a Launchpad branch. You will need python-sphinx to build it. To get it run:

bzr branch ubuntu-adk

When you have checked the code out simple run:


Now load _build/html/C/adk/index.html in your web browser and you will see what we have so far.

Importantly, although you need to build the ADK here, this would not be the case with each release of the ADK. Normal users won’t download this branch; this will only be the branch contributors use. We will then run make to generate a bunch of .zip files for each translated ADK and distribute those .zip files as part of each ADK release.

Each zip file will have a base-level index.html that makes it simple to get started. In the future it could be awesome to have the guide packaged and in the Ubuntu Software Center, and make it accessible in the dash with an icon that loads it in your web-browser. We would also like to auto-generate a PDF of the ADK so users can load it on their tablets/phones/e-book readers.

You can see the Launchpad project here.

Volunteers Needed!

We have a stunning advocacy community, and together we can make the ADK something that is fun, informative, and useful to our global set of teams. As such we are looking for volunteers!

We are primarily looking for folks to help with documentation and bringing the best wiki content over to the ADK. We are also looking for some folks to help bring the best promotional materials and presentations over to it.

Documentation in the ADK is written using reStructured Text which provides a simple way of adding markup to content (it is similar to Markdown). Included in the ADK is a page that explains how to contribute documentation to the ADK – simply click the How To Help link on the front page.

To kick things off we are going to have a meeting on Thursday 13th Dec 2012 at 3pm UTC in #ubuntu-community-team to discuss the next steps in the project. Hope to see you there!

Share This
%d bloggers like this: