Meego Wiki
Views

SDK/How to create foobar sample tutorial

From MeeGo wiki
< SDK(Difference between revisions)
Jump to: navigation, search
 
(2 intermediate revisions not shown)
Line 1: Line 1:
-
This tutorial is a very quickly created example with a suggested outline for content of other tutorials.
 
-
 
== Overview ==
== Overview ==
Clear problem statement:
Clear problem statement:
-
* What are you demonstrating?
+
* One line summary, e.g. "This tutorial is a very quickly created example with a suggested outline for content of other tutorials"
-
* Why would someone want to follow this tutorial?
+
* What the tutorial demonstrates
-
* What should the end result be?
+
* Why you should want to follow this tutorial
 +
* The end result you should expect
== Pre-requisites ==  
== Pre-requisites ==  
Line 21: Line 20:
The system you need:
The system you need:
-
* What hardware do you need?
+
* Required hardware
-
* What software needs to be installed?
+
* What software needs to be installed
-
* How does the system need to be configured?
+
* How the system needs to be configured
== How to ==
== How to ==
Line 30: Line 29:
* Solution in a nutshell
* Solution in a nutshell
-
* Code
+
* Explanation of how to set up the project (it should either stand alone, or be linked to other tutorials which explain prerequisite steps)
 +
* Code examples with explanations (include every change and explain ''why'' you made ''each'' change)
* Screenshots (if applicable)
* Screenshots (if applicable)
-
* Troubleshooting (what if something goes wrong)
+
* Troubleshooting (what to do if something goes wrong)
== Related articles ==
== Related articles ==
Other tutorials to go on to
Other tutorials to go on to

Latest revision as of 15:03, 6 January 2011

Contents

Overview

Clear problem statement:

  • One line summary, e.g. "This tutorial is a very quickly created example with a suggested outline for content of other tutorials"
  • What the tutorial demonstrates
  • Why you should want to follow this tutorial
  • The end result you should expect

Pre-requisites

What you need to know:

  • Expected skill set: e.g. languages required
  • Level of difficulty
  • Other tutorials you should do first

System Setup

The system you need:

  • Required hardware
  • What software needs to be installed
  • How the system needs to be configured

How to

How to achieve the goal:

  • Solution in a nutshell
  • Explanation of how to set up the project (it should either stand alone, or be linked to other tutorials which explain prerequisite steps)
  • Code examples with explanations (include every change and explain why you made each change)
  • Screenshots (if applicable)
  • Troubleshooting (what to do if something goes wrong)

Related articles

Other tutorials to go on to

Personal tools