W3C home > Mailing lists > Public > public-html-diffs@w3.org > January 2009

html-author/Overview.html 1.22 Started filling out Getting Started sect

From: poot <cvsmail@w3.org>
Date: Fri, 30 Jan 2009 00:55:06 +0900 (JST)
To: public-html-diffs@w3.org
Message-Id: <20090129155506.868542BC01@toro.w3.mag.keio.ac.jp>

Started filling out Getting Started section, Added examples directory
for associated markup examples

1 Introduction
http://people.w3.org/mike/diffs/html5/html-author/Overview.1.22.html#introduction
Abstract
http://people.w3.org/mike/diffs/html5/html-author/Overview.1.22.html#abstract
2 Getting Started with HTML 5
http://people.w3.org/mike/diffs/html5/html-author/Overview.1.22.html#getting-started-with-html-5
2.1 A Basic Document
http://people.w3.org/mike/diffs/html5/html-author/Overview.1.22.html#a-basic-document
2.2 Understanding Semantics
http://people.w3.org/mike/diffs/html5/html-author/Overview.1.22.html#understanding-semantics

http://people.w3.org/mike/diffs/html5/html-author/Overview.diff.html
http://dev.w3.org/cvsweb/html5/html-author/Overview.html?r1=1.21&r2=1.22&f=h

===================================================================
RCS file: /sources/public/html5/html-author/Overview.html,v
retrieving revision 1.21
retrieving revision 1.22
diff -u -d -r1.21 -r1.22
--- Overview.html	29 Jan 2009 14:50:10 -0000	1.21
+++ Overview.html	29 Jan 2009 15:54:11 -0000	1.22
@@ -59,6 +59,7 @@
 	   in depth information for more advanced web developers.</p>
 </section>
 
+<!-- Status -->
 <section>
 	<h2 class="no-num no-toc" id=status>Status of this document</h2>
 	<p><em>This section describes the status of this document at the time of its
@@ -94,15 +95,17 @@
 	   <a href=http://www.w3.org/Consortium/Patent-Policy-20040205/#sec-Disclosure>section 6 of the W3C Patent Policy</a>.</p>
 </section>
 
+<!-- Table of Contents -->
 <section>
 	<h2 class="no-num no-toc" id=contents>Table of contents</h2>
 	
 <!--begin-toc-->
 <ol class=toc>
  <li><a href=#introduction><span class=secno>1 </span>Introduction</a></li>
- <li><a href=#introductory-tutorial><span class=secno>2 </span>Introductory Tutorial</a>
+ <li><a href=#getting-started-with-html-5><span class=secno>2 </span>Getting Started with HTML 5</a>
   <ol class=toc>
-   <li><a href=#understanding-semantics><span class=secno>2.1 </span>Understanding Semantics</a></li></ol></li>
+   <li><a href=#a-basic-document><span class=secno>2.1 </span>A Basic Document</a></li>
+   <li><a href=#understanding-semantics><span class=secno>2.2 </span>Understanding Semantics</a></li></ol></li>
  <li><a href=#the-html-and-xhtml-syntax><span class=secno>3 </span>The HTML and XHTML Syntax</a>
   <ol class=toc>
    <li><a href=#html><span class=secno>3.1 </span>HTML</a></li></ol></li>
@@ -120,6 +123,7 @@
 <!--end-toc-->
 </section>
 
+<!-- Introduction -->
 <section>
 	<h2 id=introduction><span class=secno>1 </span>Introduction</h2>
 	
@@ -153,8 +157,9 @@
 	   designed to be used for a range of different use cases.</p>
 </section>
 
+<!-- Tutorial -->
 <section>
-	<h2 id=introductory-tutorial><span class=secno>2 </span>Introductory Tutorial</h2>
+	<h2 id=getting-started-with-html-5><span class=secno>2 </span>Getting Started with HTML 5</h2>
 
 	<p>The most common format for publishing documents on the web and creating
 	   web applications is HTML.  From its beginning as a relatively simple
@@ -165,20 +170,31 @@
 
 	<p>As the uses of HTML have grown, the demands placed upon it by authors
 	   have increased and the limitations of HTML become more pronounced.
-	   HTML 5 is attempting to fill these limitations with new features designed
-	   specifically the address the needs of authors.</p>
+	   HTML 5 is represents the next major step in the development of HTML,
+	   introducing a wide range of new features into the language.  Authors who
+	   are familiar with previous versions of HTML are advised to familiarise
+	   themselves with <a href=http://www.w3.org/TR/html5-diff/>the
+	   differences from HTML 4</a> [HTML4DIFF]</p>
 
-	<p>However, the way the HTML5 specification is written is very much targeted
-	   towards implementers rather than web designers and developers, making it
-	   more difficult to read and understand. This document is intended to meet
-	   the needs of web developers by focussing on document conformance criteria
-	   and authoring guidelines.</p>
+	<p>This section provides an introductory tutorial to help get you started
+	   with HTML, and is suitable for beginners.  Experienced authors may choose
+	   to skip this section and proceed to the syntax overview and the element
+	   reference.</p>
 
-	<p>Authors who are familiar with previous versions of HTML are advised to
-	   familiarise themselves with <a href=http://www.w3.org/TR/html5-diff/>the differences from HTML 4</a> [HTML4DIFF]</p>
+	<section>
+		<h3 id=a-basic-document><span class=secno>2.1 </span>A Basic Document</h3>
+		
+		<p>To begin, we're going to create a very basic HTML document, which
+		   will also serve as a useful template for future HTML documents. All
+		   HTML documents need to begin with a DOCTYPE.</p>
+		
+		<div class="html example">
+			<pre>&lt;!DOCTYPE html&gt;</pre>
+		</div>
+	</section>
 
 	<section>
-		<h3 id=understanding-semantics><span class=secno>2.1 </span>Understanding Semantics</h3>
+		<h3 id=understanding-semantics><span class=secno>2.2 </span>Understanding Semantics</h3>
 
 		<p>In general, the purpose of writing and publishing a document is to convey
 		   information to the readers.  This could be any kind of information, such
@@ -190,9 +206,10 @@
 		   is often grouped into different sections containing a variety of
 		   headings, paragraphs, lists, tables, quotes and various other
 		   typographical structures.  All of these structures are important for more
-		   easily conveying information to the reader and thus authors need a way to
+		   easily conveying information to the reader.  HTML provides the means to
 		   clearly identify each of these structures in a way that can then be
-		   easily presented to the user.  This is the purpose of markup.</p>
+		   easily presented to the user.  In essence, this is the purpose of
+		   markup, and HTML in particular.</p>
 
 		<p>Markup is a machine readable language that describes aspects of a
 		   document such as its structure, semantics and/or style. Some markup

Index: Overview.src.html
===================================================================
RCS file: /sources/public/html5/html-author/Overview.src.html,v
retrieving revision 1.23
retrieving revision 1.24
diff -u -d -r1.23 -r1.24
--- Overview.src.html	29 Jan 2009 14:50:10 -0000	1.23
+++ Overview.src.html	29 Jan 2009 15:54:12 -0000	1.24
@@ -61,6 +61,7 @@
 	   in depth information for more advanced web developers.</p>
 </section>
 
+<!-- Status -->
 <section>
 	<h1 class="no-num no-toc" id="status">Status of this document</h1>
 	<p><em>This section describes the status of this document at the time of its
@@ -96,11 +97,13 @@
 	   <a href="http://www.w3.org/Consortium/Patent-Policy-20040205/#sec-Disclosure">section 6 of the W3C Patent Policy</a>.</p>
 </section>
 
+<!-- Table of Contents -->
 <section>
 	<h1 class="no-num no-toc" id="contents">Table of contents</h1>
 	<!--toc-->
 </section>
 
+<!-- Introduction -->
 <section>
 	<h1>Introduction</h1>
 	
@@ -134,8 +137,9 @@
 	   designed to be used for a range of different use cases.</p>
 </section>
 
+<!-- Tutorial -->
 <section>
-	<h1>Introductory Tutorial</h1>
+	<h1>Getting Started with HTML 5</h1>
 
 	<p>The most common format for publishing documents on the web and creating
 	   web applications is HTML.  From its beginning as a relatively simple
@@ -146,17 +150,39 @@
 
 	<p>As the uses of HTML have grown, the demands placed upon it by authors
 	   have increased and the limitations of HTML become more pronounced.
-	   HTML 5 is attempting to fill these limitations with new features designed
-	   specifically the address the needs of authors.</p>
+	   HTML 5 is represents the next major step in the development of HTML,
+	   introducing a wide range of new features into the language.  Authors who
+	   are familiar with previous versions of HTML are advised to familiarise
+	   themselves with <a href="http://www.w3.org/TR/html5-diff/">the
+	   differences from HTML 4</a> [HTML4DIFF]</p>
 
-	<p>However, the way the HTML5 specification is written is very much targeted
-	   towards implementers rather than web designers and developers, making it
-	   more difficult to read and understand. This document is intended to meet
-	   the needs of web developers by focussing on document conformance criteria
-	   and authoring guidelines.</p>
+	<p>This section provides an introductory tutorial to help get you started
+	   with HTML, and is suitable for beginners.  Experienced authors may choose
+	   to skip this section and proceed to the syntax overview and the element
+	   reference.</p>
 
-	<p>Authors who are familiar with previous versions of HTML are advised to
-	   familiarise themselves with <a href="http://www.w3.org/TR/html5-diff/">the differences from HTML 4</a> [HTML4DIFF]</p>
+	<section>
+		<h1>A Basic Document</h1>
+
+		<p>To begin, we're going to create a very basic HTML document, which
+		   will also serve as a useful template for future HTML documents. Open
+		   a text editor and create a new, empty file.  I suggest you save the
+		   file as <kbd>example01.html</kbd>.</p>
+
+		<p>All HTML documents need to begin with a DOCTYPE. In your text editor,
+		   type the following on the first line, and save the file.</p>
+
+		<div class="html example">
+			<pre>&lt;!DOCTYPE html&gt;</pre>
+		</div>
+		
+		<p>It's good practice to get in the habit of always typing that as the
+		   first line in all new HTML documents you create. This line is used
+		   to indicate that the document is an HTML 5 document</p>
+
+		<p></p>
+
+	</section>
 
 	<section>
 		<h1>Understanding Semantics</h1>
@@ -171,9 +197,10 @@
 		   is often grouped into different sections containing a variety of
 		   headings, paragraphs, lists, tables, quotes and various other
 		   typographical structures.  All of these structures are important for more
-		   easily conveying information to the reader and thus authors need a way to
+		   easily conveying information to the reader.  HTML provides the means to
 		   clearly identify each of these structures in a way that can then be
-		   easily presented to the user.  This is the purpose of markup.</p>
+		   easily presented to the user.  In essence, this is the purpose of
+		   markup, and HTML in particular.</p>
 
 		<p>Markup is a machine readable language that describes aspects of a
 		   document such as its structure, semantics and/or style. Some markup
Received on Thursday, 29 January 2009 15:55:43 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Saturday, 18 December 2010 06:13:57 GMT