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

Editing/writing tutorials

Tone
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

Actionscript
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.

Language
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!

Comments

  • 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: doc_chin7
» Description:

The flash's horizontal road drive was done in CS4 and was upgraded to CS6. The car responds to right/ left key and flash will auto-generate the movement of roads from left-right or right-left based on random number. Have fun driving in this virtual environment and avoid other cars... :) If you are creative, a road driving game can be created from it.

Featured Sound Loops
Image for equalize

Audio Player

» Author: BoxCat
» Title: CPU Talk
» Description: From the cyberpunk RPG, "Nameless: the Hackers" Completely Free to use! Keywords: edm hip hop rap electronic mysterious mission hacking chase exciting spy ios ambient chilling love happy sad angry suspense
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: nathan
» Description:

A recorded sound of the Dimensional Fork Gate.