PDA

View Full Version : Beginners FAQ



Lurker
04-13-2004, 06:58 PM
I'm the new mod of a site a guy created for web and computer development. I created a basic C FAQ, but I think it's way too advanced for a beginner. Is it just me? What do you think? The FAQ is here (http://ajwebdevelopment.com/forums/viewtopic.php?t=37). Thanks :D !

ober
04-14-2004, 06:47 AM
AHHHHHHHHHHHHHHH!!!!!!!!!!!

I can't take it anymore. Installing a bulletin board is NOT considered "creating a web site". And making a POST in that board should NOT be considered a good place for an FAQ either.

Prelude
04-14-2004, 06:57 AM
>but I think it's way too advanced for a beginner
The topic isn't, but the way you go about explaining it can be confusing. You use a lot of standard programming terminology without defining it. Remember that your target audience has no knowledge of programming, so you can't assume that they'll understand any words you take for granted (like 'parameter').

>What do you think?
Not bad.

Thantos
04-14-2004, 07:03 AM
I can't take it anymore. Installing a bulletin board is NOT considered "creating a web site". Double that sentiment if its phpbb. But dude they have one page setup at the root directory. :)

ober
04-14-2004, 07:24 AM
I hadn't even considered that part of the site because it's ****ing HIDEOUS and worthless to boot.

Thantos
04-14-2004, 07:34 AM
Sorry I used the wrong smiley. It should have been :rolleyes:

And I thought I was bad at webpage design. At least I know it and don't try to make it a business.

Glirk Dient
04-14-2004, 01:51 PM
Well, the link didnt work for me, but assume your audience knows NOTHING...like it is someone that just bought their first computer, signed onto the intarweb with AOL and is reading this. On the flip side don't spend too much time teaching the basics of computer terms and what not so the programmer reading it for reference has a use for it.

Second, the people you should first be asking is people that are not programmers, not for the material but if they can read a bit of it and understand what's going on because as confusing of a guide you may read we will tend to peice it together to understand what's going...afterall we already know the language and peice together more complicated stuff when we are given old code. So, perhaps you should head to a non programming forums and start posting...anyways I am rambling again so I will just finish this the way it is.

Lurker
04-14-2004, 04:08 PM
>but I think it's way too advanced for a beginner
The topic isn't, but the way you go about explaining it can be confusing. You use a lot of standard programming terminology without defining it.
That's what I meant.

Remember that your target audience has no knowledge of programming, so you can't assume that they'll understand any words you take for granted (like 'parameter').

You're right, but how can I add those without getting even more confusing?


>What do you think?
Not bad.

Thanks.

Lurker
04-14-2004, 04:09 PM
Sorry I used the wrong smiley. It should have been :rolleyes:

And I thought I was bad at webpage design. At least I know it and don't try to make it a business.
I know - this guy's a little off his rocker. But hey, why pass up a chance for moderator? I said create a website because he signed up for a domain, paid money (I would think), and created a page and set up a forum.

Prelude
04-14-2004, 04:16 PM
>but how can I add those without getting even more confusing?
You only use terminology that you have to, and then define it in terms that the target audience will understand before using it. For example:

"A variable is a little box that holds things. Boxes are categorized by what they hold, called the type. So a box of int (short for integer) holds numbers. The boxes are called variables because you can take things out of a box and put other things of the same type in."

XSquared
04-14-2004, 04:21 PM
And typecasting is when you use a hammer to make something of another type go into the box.

Thantos
04-14-2004, 04:28 PM
I was thinking more along the lines of a weilding gun :)

XSquared
04-14-2004, 04:30 PM
But how would you fit an 8-byte double into a 4-byte float with a welding torch? A plasma torch on the other hand...

RoD
04-14-2004, 05:39 PM
Double that sentiment if its phpbb. But dude they have one page setup at the root directory. :)

hey you kiss my ass that smf really sucks. Real men dont use smf :P

Thantos
04-14-2004, 05:42 PM
Script kiddies use phpbb :)

RoD
04-14-2004, 07:32 PM
people with no traffic that isnt forced use smf :P