First time here? First time here? Newsletter Signup Newsletter
Login | Register | 651326 Members and growing!
Search tutorials
Author: Eddie Carroll | Website: http://www.flashkit.com

Editing/writing tutorials

The tone of the writing should foster a positive learning environment. The tutorial should be written in the first person and provide a narrative (story) of the step by step process.

Overall Structure
The following is a recommend stucture for the web and for flashkit tutorials. It allows for scannability and for deeper consumption of information.

    Para 1. Summary of what you are about to teach, why it's important
    Para 2. Example.swf - this is placed high up on the structure so when the page is loaded, it is visible without using the vertical scrollbar.
    Para 3. Step one of tutorial
    Para n. Final step
    Para n+1. Closing discussion/links
    Para n+2. Quick Reference (if necessary) see further on for details.

Paragraph Structure

The web is different to any other medium as a result people read it differently too. The flashkit tutorials use scannable text which means paragraphs should contain the following elements:

  • Highlighted keywords
  • Meaningful subheadings
  • Bulleted lists
  • One idea per paragraph
  • low word limit

Many tute writers forget to add the all important element to their tutes - Actionscript. Even thought the source code is provided, people like to have the Actionscript in the tute to help them understand what is going on. When adding code to a tute use the

 tags, flashkit will do the rest.

This is an issue because flashkit is a global site and a significant proportion of its visitors do not use english as their first language. Some who can't use english simply download the source code. Thus it is important to keep the language of a tutorial to year 7 standard. This sounds low however we want to include as many people as possible.

» Level Basic

Added: 2000-06-20
Rating: 6 Votes: 115
(10 being the highest)
» Author
Eddie is the Content Editor at Flashkit.com and is actually a sentient Gateway Solo 2150xl notebook that suffers from acute lysdexia and caffeine addiction. He is carried on the shoulders of a semi-autonomous human called "Body".
» Download
Download the files used in this tutorial.
» Forums
More help? Search our boards for quick answers!


  • There are no comments yet. Be the first to comment!

  • You must have javascript enabled in order to post comments.

Leave a Comment
  • Your email address will not be published. All fields are required.
Featured Flash FLA
» Author: Inocreato
» Title: RaiseTheBlocks
» Description: Raise all the blocks to win the game
Featured Sound Loops
Image for equalize

Audio Player

» Author: TomCat Carty
» Title: The Wood
» Description: Just a little game ending or it can maybe be looped. Recorders with music box and percussion to give the feel of well, I don't know, the woods? Free to use, just credit me. thank you
Latest Font
» Author: Fábio FAFERS
» Description: I created this font for free use. Everyone can apply it in personal or business texts. Its free, but I want to be communicated in case of business use. Donations are accepted to keep the project of free fonts alive! Thank you all
Featured Sound Fx
Image for equalize

Audio Player

» Author: Davisigner
» Description: Hmm... what to say about this one? It's reminiscent of the closing notes of the opening music from the Three Stooges done in a church organ style with a closing cymbal crash. I'll give this one away gratis, but feel free to check out my free loops and potential upcoming license-mandated ones over in the respective part of Flashkit.