Data Driven Journalism Handbook

= Resources =


 * Official wiki (for development):
 * Project coordinator: Lucy Chambers & Liliana Bounegru

= Contributing =

Email bounegru [at] ejc.net

Here is an overview of each of the roles:

Author
Responsibilities
 * to produce new content
 * to provide improvements to any of the current content

Typical activities
 * drafting content in an area of the author's expertise
 * creating a paragraph or two on a data format that is not currently covered
 * finding new sources for the glossary

Process
 * pick a topic area from the list below
 * Draft your text in whatever format is most comfortable for you.
 * Email your new material to bounegru [at] ejc [dot] net or put on Google Docs and send a link to that page through to the list

Translator
We use Transifex to manage translations. The system allows you either to work offline and upload or translate in your browser. Every project within Transifex system collaborates with the others.

Responsibilities
 * to translate current content into local languages
 * to add local examples

Process:
 * Create an account at transifex.net
 * Go to the Open Data Manual project on Transifex
 * Pick your language
 * Start translating

Notes:
 * 1) you may need to request membership of relevant translation team in order to submit translations.
 * 2) If your language is not yet listed, then contact the mailing list or project coordinator

Editor
Responsibilities:
 * Become familiar with Sphinx, git, Github and reStructuredText
 * Review and proof submissions
 * Convert incoming text to reStructuredText
 * Merging designers' contributions into the text
 * Manage assignment of topics between authors
 * Facilitating mailing list discussions

Typical activities:
 * Become familiar with Sphinx, git, Github and reStructuredText
 * Communication with authors
 * Converting plain text sources to reStructuredText
 * Ensuring that any images and other creations from designers are integrated into the content

Designer
Typical activities:
 * Creating CSS-based themes for the HTML manual
 * Creating images and visualisations for inclusion as part of the manual
 * Conducting cross-browser testing of layouts
 * Developing typesetting guidelines for a print version of the manual
 * Participating in mailing list discussions

Responsibilities:
 * Developing a new theme for the manual
 * Maximising the manual's readability
 * Ensuring cross-browser compatibility

Build Manager
Responsibilities:
 * gaining a good understanding of git, Github, reStructuredText and readthedocs.org
 * building the manual from source

= Micro-tasks =

Only have half an hour to help? Here are some things that would be great if you could look into:

Visualisation related
It would be great if we could include more pictures in the manual. If you know of any visualisations which are freely licenced, please send a note to bounegru [at] ejc.net. We'll get them included in the manual.

= Sections that need authors =

= Planning =

= History =

= Sub-pages =