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

Re: Regarding HTML section of Beginners

From: Renoir Boulanger <renoir@w3.org> <renoir@w3.org>
Date: Mon, 22 Dec 2014 19:19:46 -0500
To: abhimanyu0003 <abhimanyu@japanaddicts.org>,public-webplatform@w3.org
Message-ID: <B4183307-60D5-447D-ACE2-97D21CDE04A0@w3.org>
Hi abhimanyu,


On December 19, 2014 9:00:47 AM EST, abhimanyu0003 <abhimanyu@japanaddicts.org> wrote:
>Hi,
>
>I think the html section of Beginners [1]
> is pretty inefficient. 

There's a lot to do indeed.

>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.

That's right.  But that page is also about summarizing the main concepts.

IMHO, a small html document with comments self documenting itself makes sense there.

Those basics are how you can write CSS and JavaScript in their alternate forms, how comments works, the cascade, etc.

>
>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

Right, you are welcome to work on the pages.  It's a wiki after all.

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

That makes sense.

>
>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 

That's where I disagree, but its my opinion. I'm not going to force my taste.

>and part does and means. Sort of
>like toning this beast down to look more elegant and sensible.

[snip]

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

Thanks for your contributions, as much as we are improving, thats great!

--

-- 
Renoir Boulanger  http://www.w3.org/People/#renoirb 
@renoirb               https://renoirboulanger.com/ 
World Wide Web Consortium (W3C)  http://www.w3.org/
Received on Tuesday, 23 December 2014 00:19:59 UTC

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