Difference between revisions of "TTFA2 Style Guide"

From HacktionLab: A UK-wide network tech-activists providing meet-ups, events, workshops, national skillshare gatherings and hacklabs
Jump to navigation Jump to search
(Created page with "Things to complete: Publish your news - Indymedia Style Guide: * 1,200 for the Intro and 600 words for each chapter aka article: Make it shorter if you can and accept that …")
 
 
(13 intermediate revisions by one other user not shown)
Line 1: Line 1:
Things to complete:
+
= The Style Guide =
  
Publish your news - Indymedia
+
*1,200 for the Intro and 600 words for each chapter aka article: Make it shorter if you can and accept that some could be longer.
 +
*Articles are self-contained in their own right, bound together by the introduction.
 +
*Article format ought to be: user story, current practice, software solution, (optional user story)
 +
*Articles should be introductions, without going into detailed step-by-step instructions: signposts to the information on the net.
 +
*Articles are limited to being about software technology.
 +
*It's a guide for people using IT for political activity
 +
*Focus should be on helping people to approach these topics, not be dictatorial nor about scare-mongering.
 +
*Humour and pictures should be used where possible, but not over used.
 +
*Images should be between 200 and 300 pixels wide, get a suitable image resolution.
 +
*Only use headers for title of the article and sub-headings.
 +
*It will be a PDF.
 +
*Anything we control is under CC attribution licence. Add licensing info and sources to the to article itself.
 +
*Add URL references to the article itself using link shortners
  
 +
= Common Structure for Each Article =
  
Style Guide:
+
See [[TTFA2_model_article | our model article]]. It's been agreed that each article should have a common structure as follows:
  
 
+
=== Bulleted intro ===
* 1,200 for the Intro and 600 words for each chapter aka article:  Make it shorter if you can and accept that some could be longer.
+
Each article will begin with a bulleted list that summarises what the piece is about.
* Articles are self-contained in their own right, bound together by the introduction.
+
=== real life story ===
* Article format ought to be: user story, current practice, software solution, (optional user story)
+
A real event that happened to someone.
* Articles should be introductions, without going into detailed step-by-step instructions: signposts to the information on the net.
+
=== why is this an issue & what you can do ===
* Articles are limited to being about software technology.
+
This is the main body of the article with all the info in it.
* It's a guide for NGO and grass roots activists.
+
=== what next (find out more & how to do it) ===
* Focus should be on helping people to approach these topics, not be dictatorial nor about scare-mongering.
+
This section contains link and place to go to find out more.
* Humour and pictures should be used where possible, but not over used.
 
* Images should be between 200 and 300 pixels wide, get a suitable image resolution.
 
* Only use headers for title of the article and sub-headings.
 
* It will be a PDF.
 
* Anything we control is under CC attribution licence.  Add licensing info and sources to the to article itself.
 
* Add URL references to the article itself using http://tiny.booki.cc/
 

Latest revision as of 07:15, 20 April 2012

The Style Guide

  • 1,200 for the Intro and 600 words for each chapter aka article: Make it shorter if you can and accept that some could be longer.
  • Articles are self-contained in their own right, bound together by the introduction.
  • Article format ought to be: user story, current practice, software solution, (optional user story)
  • Articles should be introductions, without going into detailed step-by-step instructions: signposts to the information on the net.
  • Articles are limited to being about software technology.
  • It's a guide for people using IT for political activity
  • Focus should be on helping people to approach these topics, not be dictatorial nor about scare-mongering.
  • Humour and pictures should be used where possible, but not over used.
  • Images should be between 200 and 300 pixels wide, get a suitable image resolution.
  • Only use headers for title of the article and sub-headings.
  • It will be a PDF.
  • Anything we control is under CC attribution licence. Add licensing info and sources to the to article itself.
  • Add URL references to the article itself using link shortners

Common Structure for Each Article

See our model article. It's been agreed that each article should have a common structure as follows:

Bulleted intro

Each article will begin with a bulleted list that summarises what the piece is about.

real life story

A real event that happened to someone.

why is this an issue & what you can do

This is the main body of the article with all the info in it.

what next (find out more & how to do it)

This section contains link and place to go to find out more.