Web Analytics Made Easy -
StatCounter How do my tutorials look? - CodingForum

Announcement

Collapse
No announcement yet.

How do my tutorials look?

Collapse
X
 
  • Filter
  • Time
  • Show
Clear All
new posts

  • How do my tutorials look?

    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

  • #2
    In the kindest possible way, I'm unsure how you expect to teach people how to use HTML when you have 25 errors in your page.
    Blog | Twitter
    Useful links: W3C HTML Validator | W3C CSS Validator | HTML 5 Guide
    CF: HTML & CSS Resources/Tutorials Thread | HTML & CSS Posting Rules and Guidelines
    Remember: no link, no code, no help!

    Comment


    • #3
      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.

      Comment


      • #4
        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!

        Comment


        • #5
          I made the layout.

          What about the content is lacking?

          Comment


          • #6
            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!

            Comment


            • #7
              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?

              Comment


              • #8
                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.

                Comment


                • #9
                  Originally posted by maxhud View Post
                  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.
                  Blog | Twitter
                  Useful links: W3C HTML Validator | W3C CSS Validator | HTML 5 Guide
                  CF: HTML & CSS Resources/Tutorials Thread | HTML & CSS Posting Rules and Guidelines
                  Remember: no link, no code, no help!

                  Comment


                  • #10
                    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.

                    Comment


                    • #11
                      Originally posted by maxhud View Post
                      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?
                      Blog | Twitter
                      Useful links: W3C HTML Validator | W3C CSS Validator | HTML 5 Guide
                      CF: HTML & CSS Resources/Tutorials Thread | HTML & CSS Posting Rules and Guidelines
                      Remember: no link, no code, no help!

                      Comment


                      • #12
                        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.

                        Comment

                        Working...
                        X