Wikijunior:Raspberry Pi/Contributing

From Wikibooks, open books for an open world
Jump to navigation Jump to search

The goal of this book is provide a useful free guide to the Raspberry Pi adapted from tutorials made by Cotswold Jam and others. The tutorials themselves are available at http://cotswoldjam.org/downloads. I have also archived these files on my GitHub and on the Wayback Machine.

To-do[edit | edit source]

  • Organise assets for Button Invaders
  • Suggestion for a Charlieplexed 7-LED "H"-shaped dice tutorial.
  • Suggestion for a game inspired by the electronics advert calendar such as Simon Says.
  • Raspberry Pi Zero cake tutorial with the printout
  • Introduction to Python tutorial
  • A No Pi! No Problem logo and wikibox similar to information and warning (uses prohibited symbol 🚫)
  • All the images for the Cotswold Jam tutorials
  • Ensure all the source code files use h3 headings and line numbers
  • Introduction to the Raspberry Pi - the ports

Types of tutorials[edit | edit source]

There are 4 types of tutorial that Cotswold Jam taught:

  • Electronics tutorials use electronic components such as breadboards, resistors, LEDs, switches and jumper wires.
  • Minecraft: Pi Edition
  • w:Scratch tutorials teach the visual Scratch language which can be attempted on just about any platform (Windows, macOS, GNU/Linux, etc.).
  • w:Raspberry Pi OS is the new name for Raspbian, these tutorials are almost engtirely software based.

Of course, we can add others providing they are compatible with a Raspberry Pi and suitable for an 8-12 year old audience.

Tasks[edit | edit source]

Additional content[edit | edit source]

  • Add tutorials – they can be obtained from: http://cotswoldjam.org/downloads. We also accept 3rd party tutorials as long as they are available under a compatible licence (public domain or CC-BY-SA)
  • No Pi, No Problem! – add instructions where possible for the Raspberry Pi OS and Scratch tutorials for setting up these to work on a standard computer running Windows, macOS or a GNU/Linux distro such as Ubuntu. We need documentation for:
  • Forward compatibility testing – test that all of these tutorials work on the latest Rasberry Pi models. The latest model is the Raspberry Pi 4, as of November 2022.
  • Introductions for each section

Wording[edit | edit source]

  • Improve wording in the chapters – the guides should be adjusted to read like a book and less like standalone leaflets. The depth and quality of guides should be consistent across chapters.
  • Conform to our Manual of Style – the guides should be run through spell-checking software such as Grammarly and usage of symbols such as en dashes (–) and em dashes (—) should be consistent.
  • Rename chapters – some chapters have names which make sense for standalone leaflets, but are not useful book chapter names.

Images[edit | edit source]

  • Add screenshots and diagrams to the tutorials - upload them to the specially-made c:Category:Raspberry Pi tutorials on Wikicommons.
  • Create SVG diagrams - ideally, all images that are not photographs nor screenshots should be c:SVG as per the Wikicommons guidelines – because they take up less file space and are infinitely rescalable. Also w:Fritzing (see below) apparently exports to SVG.
  • Recreate some low-resolution diagrams / screenshots - some images are low-resolution and may be unclear.
  • Fritzing diagrams for every electronics tutorial - every electronics tutorial should have at least one Fritzing diagram. Preferably, multiple diagrams to help illustrate each step. Fritzing charge a minimum of €8 EUR (~$10 USD or ~£7 GBP) for binaries from their website, as of November 2022: https://fritzing.org//
  • New screenshots for Scratch 3 - Scratch 3 was released in January 2019 and has a different user interface.