...

View Full Version : How do my tutorials look?



maxhud
08-19-2011, 07:54 PM
Hey.

I'm making a tutorial website (yes I know there are a lot of them)

How accurate do my tutorials seem at first look?

http://zonimer.com/?l=HTML

Thanks

Apostropartheid
08-19-2011, 08:00 PM
In the kindest possible way, I'm unsure how you expect to teach people how to use HTML when you have 25 errors (http://validator.w3.org/check?uri=http%3A%2F%2Fzonimer.com%2F%3Fl%3DHTML&charset=%28detect+automatically%29&doctype=Inline&group=0) in your page.

maxhud
08-19-2011, 08:23 PM
90% of them are ampersand errors in the link which should be accounted for by the validator, not me.

Some of the other things do need fixing, but I am asking about the content of my tutorials, not the code for my site.

DanielWatts
08-19-2011, 08:26 PM
I like the simple layout, very nice. I don't like the content, I think it's lacking, I'm wondering who made that layout, if you made it, or it's it a Content Management System, overall I rate it;

8/10!

maxhud
08-19-2011, 08:45 PM
I made the layout.

What about the content is lacking?

DanielWatts
08-19-2011, 08:48 PM
Well, in my honest opinion, I don't think you should show/release a preview of your site/template unless it's got %90 content, you've only got two sections filled in, and they are fantastic!

maxhud
08-19-2011, 08:59 PM
Oh.

Well i am not advertising for it yet, and since no one knows about it, it's not really a big deal.

I was asking about the content of the HTML tutorials.

Do they seem like good HTML tutorials?

Nightfire
08-19-2011, 09:30 PM
Only went through it quickly, in the tutorial you mention the image tag should be <img src="image.png" /> That's xhtml and will be invalid html.

Apostropartheid
08-19-2011, 09:45 PM
90% of them are ampersand errors in the link which should be accounted for by the validator, not me.

Some of the other things do need fixing, but I am asking about the content of my tutorials, not the code for my site.

...No, it should be accounted for by you. It is your website. And even if it's 90%--you still should see the absurdity of teaching HTML whilst getting it wrong yourself.

As for your content, I'm going to quickly go through things that are wrong, so this will be a negative account:
- "Standard HTML page" does not seem much different from "Tags".
- You neglect to use a doctype when writing "basic" pages. This must always be included simply because beginners don't know better
- You use XHTML syntax but only recommend HTML doctypes.
- You use inline CSS without actually explaining it: stick to HTML for now.
- "Paragraphs & Spans make it possible to write text and give it attributes. In an HTML document, you can write text outside of a span or paragraph tag, but you won't have the benefit/option of giving it styles, an id or any other attribute. They make it possible to apply attributes to text." This whole paragraph is chock full of errors.
- Your example output in Paragraphs and Spans is in bold, even though there is no code to make it so; this may prove confusing.
- The terms are "relative" and "absolute" links; an "external" link as you've defined it can actually point to an "internal" page.
- You did not mention malto: links.
- The alt attribute is required on images.
- "An HTML div simply is an HTML tag with the name div." This is not explanatory.
- The word is "helpful".
- You haven't noted the thead and tbody elements in tables.
- You have not mentioned the ol and dl elements under Lists.
- inputs cannot be a direct child of forms. The action and method attributes are required.
- You do not mention how forms are processed.
- When you're naming elements in your prose, you should set them apart with the code tag for clarity.

maxhud
08-20-2011, 01:18 AM
Alright.

Thanks Ill work on those things.

What did you mean by this?

- When you're naming elements in your prose, you should set them apart with the code tag for clarity.

Apostropartheid
08-20-2011, 02:51 PM
Alright.

Thanks Ill work on those things.

What did you mean by this?

- When you're naming elements in your prose, you should set them apart with the code tag for clarity.

For example, let's say I was talking about the table element.


The table element is used for marking up tables. tables should not be used for layout.

Do you see how, when referencing the actual HTML tag table, I have highlighted it as a piece of inline code?

DSSeattle
08-26-2011, 12:56 PM
As a beginner to HTML I would not have noticed the errors mentioned by others. However in general, it is well laid out and easy to read. As the pages are plain, there are no ads or images to distract the reader.



EZ Archive Ads Plugin for vBulletin Copyright 2006 Computer Help Forum