RevPages

HTML Codes Tutorial

by Mohemmed Elarby Web Designer,seo,Marketing,
HTML Codes Tutorial The Myth of Self Documenting HTML Code The Comment Tag Clears the Confusion!
Recommended Features
  • HTML Codes Tutorial
  • HTML Code
  • HTML
  • Tutorial
  • Documenting
Learn more about HTML Codes Tutorial»

Review on HTML Codes Tutorial

Its a common myth in some developer circles that good code is self documenting. Heck, Ive seen thousands of lines of outrageously bad code and HTML without a single line of comments. When asking the original developer they will often tell you that their code is self documenting. This myth has been used as an excuse for not documenting code and HTML so many times that it literally makes me sick.
Thats why I want to take this opportunity to take a good look at this myth. However, allow me to introduce the HTML comment tag, then at least you cant say you dont know what it looks like or what it does.


Its a really simple and easy to use tag. Even more importantly the information you provide in between the start and end comment tag can save yourself and the next developer who is looking at your HTML a ton of time!

The Myth About Self Documenting Code

Myth: Good code is self documenting and does not need comments or other sources of documentation.

Demystifying the myth: To some extent it is true that code is self explanatory. The assumption is that if you write good, elegant HTML code it will be easy to see what youre doing.

Back when the first programming languages where invented the syntax made it difficult to read what the intention was. These days you can read the code of the most common programming languages pretty much as if it was plain English. This goes for HTML code as well. Although you cant read it as if it was a novel its fairly easy to discern what each HTML tag does. In other words the code is self documenting.

Each line you read tells you exactly what it does and that has led the more laid back (lazy) developers among us to conclude that there is no need to actively document code.

Debunking the myth: I have yet to see an HTML source code file online that is less than 100 lines long. In fact, the Google main page,

Related to HTML Codes Tutorial

Related Articles

How to create HTML codes for free with an easy HTML tag generator

This short post is for the network marketer that does not know much about creating HTML. Learning HTML can be hard and time consuming. I'm not saying learning HTML is a bad idea. Education and s...

Related Resources

HTML Tutorial - W3Schools

This HTML tutorial contains hundreds of HTML examples. ... color names, entities , character-sets, URL encoding, language codes, HTTP messages, and more.

HTML Examples - W3Schools

... XML AJAX Angular ASP .NET PHP SQL tutorials, references, web building examples. ... Programming code formatting preserving whitespace and line- breaks

HTML & CSS | Codecademy

Build Your Own Webpage. Now that you know HTML, you can create your very own webpage. Let's get started! ... Logo--grey. Teaching the world how to code.

HTML Beginner Tutorial | HTML Dog

The HTML Beginner Tutorial assumes that you have absolutely no previous ... is brought together at the end, before moving on to the CSS Beginner Tutorial.

Learn to Code HTML & CSS

Learn to Code HTML & CSS is a simple and comprehensive guide dedicated to helping beginners learn HTML and CSS. Outlining the fundamentals, this guide...

Sponsor Ads


About Mohemmed Elarby Magnate II     Web Designer,seo,Marketing,

5,874 connections, 119 recommendations, 17,637 honor points.
Joined APSense since, July 3rd, 2011, From port said, Egypt.

Created on May 12th 2015 02:22. Viewed 896 times.

Comments

No comment, be the first to comment.
Please sign in before you comment.