W3C home > Mailing lists > Public > public-webplatform@w3.org > December 2014

Regarding HTML section of Beginners

From: abhimanyu0003 <abhimanyu@japanaddicts.org>
Date: Fri, 19 Dec 2014 06:00:47 -0800
To: <public-webplatform@w3.org>
Message-ID: <14a62d6bc44.ded9a76012317.1435505049591871738@japanaddicts.org>

I think the html section of Beginners [1] is pretty inefficient. That's probably not how a new user would expect such an important piece to look like. To be frank, it bores (and terrifies) the hell out of people who're trying to get a hold of what's HTML all about.

First, I think we should enter a simple introduction piece like all webpages are documents, HTML is the most used markup language, it's divided into head and body, head holds metadata, etc.

After that, we'll input the main thing, the anatomy of an HTML document.

And then, I think we should rip off the comments. It doesn't look pretty. Instead, the code sample should be short and sweet, while we analyse, with points, what each tag and part does and means. Sort of like toning this beast down to look more elegant and sensible.

I'm currently modelling the data like that. It shouldn't take more than an hour, so if someone has any problems, please clarify now.

Thanks :)

[1] https://docs.webplatform.org/wiki/Beginners/html

Received on Friday, 19 December 2014 14:01:12 UTC

This archive was generated by hypermail 2.4.0 : Friday, 17 January 2020 19:14:09 UTC