tutorial write-up format?
Page 1 of 2 12 LastLast
Results 1 to 10 of 11

Thread: tutorial write-up format?

  1. #1
    Member n00bius's Avatar
    Join Date
    Mar 2005
    Location
    texas
    Posts
    86

    Lightbulb tutorial write-up format?

    I'm putting together a tutorial and i've a habit of being terribly verbose (anal if you will) I'm curious to know what the community thinks would be a decent format for a tutorial, i.e. what to include that would make it easily readible, where at the same time highly informative and able to be recreated.

    Personally I really hate it when i can't recreate things, i.e. lets say there's some really old school bug that's really interesting, but long since patched. If there was a writeup that told all the circumstances surrounding using the exploit etc, where it could be easily recreated in a lab, ther'd be a lot less newbies, I think at least.

    I'll have an actual example out once i finish up my tutorial, but what are your thoughts?..what would be a decent format?
    Last edited by n00bius; July 19th, 2007 at 05:03 PM. Reason: anonymous tip about the increased readability of paragraphs
    ...:::Pure Kn0wledge:::...

  2. #2
    Senior Member
    Join Date
    Oct 2003
    Location
    MA
    Posts
    1,052
    I dont think people really mind what "format" it is in. I think the key is to just keep it organized. Headings and indents are key.

    Good luck!

  3. #3
    Senior Member nihil's Avatar
    Join Date
    Jul 2003
    Location
    United Kingdom: Bridlington
    Posts
    17,190
    I'm putting together a tutorial and i've a habit of being terribly verbose (anal if you will) I'm curious to know what the community thinks would be a decent format for a tutorial, i.e. what to include that would make it easily readible, where at the same time highly informative and able to be recreated. Personally I really hate it when i can't recreate things, i.e. lets say there's some really old school bug that's really interesting, but long since patched. If there was a writeup that told all the circumstances surrounding using the exploit etc, where it could be easily recreated in a lab, ther'd be a lot less newbies, I think at least. I'll have an actual example out once i finish up my tutorial, but what are your thoughts?..what would be a decent format?
    Try paragraphs?

  4. #4
    Senior Member
    Join Date
    Oct 2003
    Location
    MA
    Posts
    1,052
    lol nihil

  5. #5
    Senior Member WolfeTone's Avatar
    Join Date
    Jun 2007
    Location
    Ireland
    Posts
    197
    Once it's easy to follow and descriptive - that's all you need IMO.

  6. #6
    Senior Member mungyun's Avatar
    Join Date
    Apr 2004
    Location
    Illinois
    Posts
    172
    Big suggestion: Dont go on tangents. That is, if you start talking about something stick all the way through that subject. Even if you hit another topic that may require explaining, hold out till after you explain the current one.

    I have found many many tutorials that go from one thing to the next and back again, very confusing.

    Also if your tutorial is going to be long make sure to organize it before putting it out for everyone to read. Hit topics in order so that there is a 'flow' to them.

    Lastly, tutorials are much easier and enjoyable to read if there is a little humor in them. Long tutorials can be very boring depending on the topic and a little humor goes a looong way.

    Good luck
    I believe in making the world safe for our children, but not our childrenís children, because I donít think children should be having sex. -- Jack Handey

  7. #7
    Senior Member
    Join Date
    Apr 2005
    Location
    USA
    Posts
    422
    Quote Originally Posted by mungyun
    Big suggestion: Dont go on tangents. That is, if you start talking about something stick all the way through that subject. Even if you hit another topic that may require explaining, hold out till after you explain the current one...Lastly, tutorials are much easier and enjoyable to read if there is a little humor in them. Long tutorials can be very boring depending on the topic and a little humor goes a looong way.
    I'll have to agree with mungyun here. Staying on topic is a foundation for a solid tutorial.
    Don't forget to read this:
    http://antionline.com/showthread.php?t=254750
    There are lots of things I wouldn't have thought of myself, if I were to write a tutorial, that are contained in this thread. Many of these things go hand in hand with all writing, so think of it like writing a paper in school. For example, it is stated in the topic i listed above, don't write your paper in one day. Give your mind some time to get off the subject, then you will view it in a new light.

    and btw, I rely on smart people writing good tutorials for most of my learning, so the pressure is on you!

  8. #8
    Senior Member t34b4g5's Avatar
    Join Date
    Sep 2003
    Location
    Australia.
    Posts
    2,391

    Question

    As long as it has animated stick figure .gif's throughout the tutorial, then it carn't be that bad..

    But seriously though if you choose a topic for a tutorial then stick to that topic and if you hit something that talks about some other topic then maybe make another tutorial touching on the other topic...?

    also simple pictures add some wow to a tutorial, and also help to understand the tutorial.

    just a few ideas thrown into the mix.

  9. #9
    Senior Member nihil's Avatar
    Join Date
    Jul 2003
    Location
    United Kingdom: Bridlington
    Posts
    17,190
    Deth by Powerpoint peut etre mes amis?

    I have a brilliant sequence of a ground attacks by 4 F-16s

    Then there is this stuff I got from a mate........... I guess it was a bad day for the Taliban................ we have my mate (2 recon) and a couple of guys off the USS America or whatever........ they are F-14 Tomcats................ OMFG The taliban armour flying through the air?

    Oh well?
    Last edited by nihil; July 20th, 2007 at 04:45 PM.

  10. #10
    Member n00bius's Avatar
    Join Date
    Mar 2005
    Location
    texas
    Posts
    86
    lol, wow @nihil, taking everything into account i think its going to be a job. thanks for the input.
    ...:::Pure Kn0wledge:::...

Similar Threads

  1. Windows Error Messages
    By cheyenne1212 in forum Miscellaneous Security Discussions
    Replies: 7
    Last Post: February 1st, 2012, 02:51 PM
  2. An Antionline Tutorial - The Way it Should Be
    By er0k in forum Other Tutorials Forum
    Replies: 21
    Last Post: March 25th, 2010, 12:31 PM
  3. Read Me First
    By Negative in forum The Security Tutorials Forum
    Replies: 12
    Last Post: June 2nd, 2004, 02:09 AM
  4. Tcp/ip
    By gore in forum Newbie Security Questions
    Replies: 11
    Last Post: December 29th, 2003, 08:01 AM
  5. Assembly Tutorials Online
    By mathgirl32 in forum Programming Security
    Replies: 4
    Last Post: January 25th, 2003, 04:05 AM

Posting Permissions

  • You may not post new threads
  • You may not post replies
  • You may not post attachments
  • You may not edit your posts
  •