Finished! View manual/FAQ here --> https://confluence.suse.com/display/~mavedon/Hackweek+2023

Project Description

Video game manuals from the 1980s and 1990s use simple language and illustrations to introduce users to software. Let's apply some of those design ideas to the Rancher docs.

Goal for this Hackweek

Create a brief manual describing what Rancher is and how to get started. We'll use annotated screenshots, color-coding, two-page spreads, arrows, and writing aimed at a middle school reading level.

For MVP, we can go for a website in this style, with a .pdf version as a parallel/stretch goal. Creating an ASCII game FAQ might be a good way to create an initial draft.

Resources

We'll need writers, illustrators, editors, "play testers", and retro gaming fans.

  • Vimm's Lair scan of "Pokemon Yellow" manual: https://vimm.net/manual/3135
  • Reading level calculator: https://www.wordcalc.com/readability/
  • Open source print layout software: https://www.scribus.net/downloads/

Looking for hackers with the skills:

Nothing? Add some keywords!

This project is part of:

Hack Week 23

Activity

  • 12 months ago: ancorgs liked this project.
  • about 1 year ago: binary_sequence liked this project.
  • about 1 year ago: vneuhauss joined this project.
  • about 1 year ago: mavedon started this project.
  • about 1 year ago: mavedon originated this project.

  • Comments

    • binary_sequence
      about 1 year ago by binary_sequence | Reply

      Also as an idea, the Toyota A3 report format: https://www.lean.org/lexicon-terms/a3-report/

    Similar Projects

    This project is one of its kind!