3  Article Templates

Note: [Edit on GDocs] | [Raise ticket for review and publishing]

There are different article types each with its own guidelines. Please find the details below. In summary:

  1. Section introduction
  2. Quick start guide
  3. Overview / Essay / Expository text
  4. Project highlight or example
  5. Step-by-step guide
  6. Info box style

3.0.1 Section introduction

(To be written by section editor)

Example: TBC

  • Total for the article 700 words.

  • The text is a maximum of 400 words (including: title and headline, tables, figures, and photos)

  • One image

  • Add three or more learning outputs in an ‘Info box template style’ (see instructions at end of template list). An additional 300 words can be given to the learning outputs part. Example:

3.0.2 Quick start guide

Example: p5 example from SciStarter guide
This could be to introduce a topic, or a service someone could use, like FloraIncognita (plant ID app).

  • Main title, subtitle
  • Definition box: 6 bullet points
  • Video online tutorial: Title; image; description 40 words; URL link
  • Learn more: List of supporting resources — 135 words

3.0.3 Overview / Essay / Expository text

Example: p6 example from SciStarter

3.0.3.1 3 page version

  • Total 850 words

  • Title, subtitle

  • Two images in main text

  • Main text: Use bullet points and sub-headers; 650 words

  • Summarise main points in infobox. No more than four points. 80 words.

  • End section to show how libraries can make use of ideas, with examples for resources. Title; 120 words total.

3.0.3.2 4 page version

  • Total character length 1320 words

  • Title, subtitle

  • Main text: Use bullet points and sub-headers; 1120 words total

  • Use a series of small images — 7 max. If images are described in the text then no picture caption is needed.

  • Use two info boxes to highlight important issues with bullet points and use an image here if preferred. 100 words each.

3.0.4 Project highlight or example

(This could also count for a video piece or single page project example)

Example: p20 example from SciStarter

  • Title

  • Headline description 20 words

  • One or two images

  • Text: Up to 180 words

3.0.5 Step-by-step guide

3.0.5.1 Short version

3.0.5.1.1 Example: p28 SciStarter
  • Title, headline 12 words

  • 625 words; Use bullet points and sub-headers

  • 2-4 images

3.0.5.2 Long version

3.0.5.2.1 Example: p30 SciStarter
  • Title, headline 12 words

  • 1,750 words total

  • 10 pictures max

  • Break process into no more than 7 steps of 65 words each

  • Then following text

3.0.6 Info box style

3.0.6.0.1 Example: