wiki-based_documentation_proje.html 15.8 KB

Raw Blame History Permalink

<?xml version="1.0"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
  <head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    <style type="text/css" media="all">
    @import "/QA/2006/01/blogstyle.css";
    </style>
    <meta name="keywords" content='CSS, education, HTML, open web, tutorial' />
    <meta name="description" content="Introduce myself My name is Hiroki Yamada. I am a W3C Fellow from Internet Academy (Japanese company). Internet Academy is a school for Web Designers and Web Developers. I've been in charge of developing on curriculum and educational materials. And..." />
    <meta name="revision" content="$Id: wiki-based_documentation_proje.html,v 1.36 2011/12/16 03:00:14 gerald Exp $" />
   <link rel="alternate" type="application/atom+xml" title="Atom" href="http://www.w3.org/QA/atom.xml" />
   <link rel="alternate" type="application/rss+xml" title="RSS 1.0" href="http://www.w3.org/QA/news.rss" />
   <title>Wiki-based documentation project - W3C Blog</title>

   <link rel="start" href="http://www.w3.org/QA/" title="Home" />
   <link rel="prev" href="http://www.w3.org/QA/2011/04/openweb-weekly-05.html" title="Open Web Platform Weekly Summary - 2011-03-28 - 2011-04-03" />
   <link rel="next" href="http://www.w3.org/QA/2011/04/government_data_done_well_and.html" title="Government Data Done Well and the Digital Agenda for Europe" />

   <!--
<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
         xmlns:trackback="http://madskills.com/public/xml/rss/module/trackback/"
         xmlns:dc="http://purl.org/dc/elements/1.1/">
<rdf:Description
    rdf:about="http://www.w3.org/QA/2011/04/wiki-based_documentation_proje.html"
    trackback:ping="http://www.w3.org/QA/sununga/mt-tb.cgi/382"
    dc:title="Wiki-based documentation project"
    dc:identifier="http://www.w3.org/QA/2011/04/wiki-based_documentation_proje.html"
    dc:subject="Tutorials"
    dc:description="Introduce myself My name is Hiroki Yamada. I am a W3C Fellow from Internet Academy (Japanese company). Internet Academy is a school for Web Designers and Web Developers. I&apos;ve been in charge of developing on curriculum and educational materials. And..."
    dc:creator="Hiroki Yamada"
    dc:date="2011-04-04T20:02:50+00:00" />
</rdf:RDF>
-->

    <!-- <script type="text/javascript" src="http://www.w3.org/QA/mt.js"></script>-->

</head>
<body class="layout-one-column">
      <div id="banner">
      <h1 id="title">
	<a href="http://www.w3.org/"><img height="48" alt="W3C" id="logo" src="http://www.w3.org/Icons/WWW/w3c_home_nb" /></a>
W3C Blog
</h1>
    </div>

    <ul class="navbar" id="menu">
        <li><strong><a href="/QA/" title="W3C Blog Home">[ W3C Blog ]</a></strong></li>
        <li><a href="/QA/Library/" title="Documents and Publications on Web and Quality">Documents</a></li>
        <li><a href="/QA/Tools/" accesskey="3" title="Validators and other Tools">Tools</a></li>
        <li><a href="/2007/12/qa-blog-help/index#feedback">Feedback</a></li>
    </ul>
<div id="searchbox">
<form method="get" action="http://www.google.com/custom" enctype="application/x-www-form-urlencoded">
<p id="formbox"><input type="text" size="15" class="textfield" name="q" accesskey="E" maxlength="255" /> <input type="submit" class="submitfield" value="Search" id="goButton" name="sa" accesskey="G" /> <input type="hidden" name="cof" value="T:black;LW:72;ALC:#ff3300;L:http://www.w3.org/Icons/w3c_home;LC:#000099;LH:48;BGC:white;AH:left;VLC:#660066;GL:0;AWFID:0b9847e42caf283e;" /><input type="hidden" id="searchW3C" name="sitesearch" checked="checked" value="www.w3.org/QA" /><input type="hidden" name="domains" value="www.w3.org/QA" /></p>
</form>
</div>


    <div id="main"><!-- This DIV encapsulates everything in this page - necessary for the positioning -->

                     <p class="content-nav">
                        <a href="http://www.w3.org/QA/2011/04/openweb-weekly-05.html">&laquo; Open Web Platform Weekly Summary - 2011-03-28 - 2011-04-03</a> |
                        <a href="http://www.w3.org/QA/">Main</a>
                        | <a href="http://www.w3.org/QA/2011/04/government_data_done_well_and.html">Government Data Done Well and the Digital Agenda for Europe &raquo;</a>
                     </p>

                        <h2 class="entry-header">Wiki-based documentation project</h2>
                           <div class="entry-body">
                              <h3>Introduce myself</h3>

<p>My name is Hiroki Yamada. I am a W3C Fellow from <a href="http://www.internetacademy.jp/">Internet Academy</a> (Japanese company). Internet Academy is a school for Web Designers and Web Developers. I've been in charge of developing on curriculum and educational materials. And now, I'm working on making the wiki-based documentation of W3C specifications at W3C.</p>

<h3>Background & Status</h3>

<p>W3C has released a lot of specifications with rapid growth of the Web technology. Each specification is very large, which is a good thing. However, understanding specifications is difficult for beginners. In order to facilitate the learning process, we should train Web Designers and Web Developers from beginner to professional level. Achieving this goal is important for the growth and development of the World Wide Web. This is why I began this project.</p>

<p>I've finished developing two documents. The first document is the <a href="http://www.w3.org/wiki/HTML/Training">Educational Materials for Beginners</a>, and the second is the <a href="http://www.w3.org/wiki/HTML/Elements">List of HTML Elements</a>. However, these documents are just a first step for this project, which is just beginning. We also have an <a href="http://www.w3.org/wiki/Open_Web_Platform">Open Web Platform page</a>. I will continue writing documentation for other specifications that relate to the Open Web Platform.</p>

<p>In this entry, I explain three features of the documentation of HTML.</p>

<h3>HTML documentation's features</h3>

<p>First, these documentations present the information simply. They must do this because the project's intended targets are only beginners in Web design. For beginners, specifications are not easy to read because they have too much information. My documentations contain only the basic information that beginners need. In addition, they present links to specifications that give insightful information.  I have also continued to focus on keeping the educational materials both easy to read and easy to understand.</p>

<p>Second, they utilize many examples in order to better describe how HTML works. This is important because I think that it is difficult for a beginner to understand how the elements of HTML are used. For exactly the same reason, they also provide examples of bad HTML usage and screenshot images.</p>

<p>Finally, I set up a working web development curriculum for beginners since they don't know how to effectively organize their study. From here they can create a fake site according to the flow of the curriculum. And also, they cover not only HTML, but also provide instructions for the next step. I've finished editing the <a href="http://www.w3.org/wiki/CSS/Training">CSS Educational Materials for Beginners</a>, so people who study Web technology can advance step by step from one level to the next.</p>

<p>I very much welcome bug reports and suggestions for improvements by sending feedback to the publicly archived mailing list <a href="mailto:public-webdev-docs@w3.org">public-webdev-docs@w3.org</a> [<a href="http://lists.w3.org/Archives/Public/public-webdev-docs/">Web archive</a>].</p>

                           </div>
                           <div id="more" class="entry-more">


                           </div>
                       <p class="postinfo">Filed by <a href="">Hiroki Yamada</a> on April  4, 2011  8:02 PM in <a href="http://www.w3.org/QA/archive/technology/css/">CSS</a>, <a href="http://www.w3.org/QA/archive/technology/html/">HTML</a>, <a href="http://www.w3.org/QA/archive/open_web/">Open Web</a>, <a href="http://www.w3.org/QA/archive/w3cqa_news/tools/">Tools</a>, <a href="http://www.w3.org/QA/archive/web_spotting/tutorials/">Tutorials</a><br />
<span class="separator">|</span> <a class="permalink" href="http://www.w3.org/QA/2011/04/wiki-based_documentation_proje.html">Permalink</a>
                                 | <a href="http://www.w3.org/QA/2011/04/wiki-based_documentation_proje.html#comments">Comments (6)</a>
                                 | <a href="http://www.w3.org/QA/2011/04/wiki-based_documentation_proje.html#trackback">TrackBacks (0)</a>
</p>


<h3 class="comments-header" id="comments">Comments</h3>
<div class="comment" id="comment-222886">
<p class="comment-meta" id="c222886">
<span class="comment-meta-author"><strong>karl dubost </strong></span>
<span class="comment-meta-date"><a href="#c222886">#</a> 2011-04-04</span>
</p>
<div class="comment-bulk">
<p>One thing important to note is that the <a href="http://www.w3.org/wiki/" rel="nofollow">W3C wiki</a> is open to anyone. You just need an account the same way, you would have an account on wikipedia.</p>

<p>You can <a href="http://www.w3.org/Help/Account/Request/Public" rel="nofollow">get a public account</a> on W3C site and starts edit the page. The more people contributing, the better for the quality of the content. </p>

<p>It's also an important site because it brings a vendor neutral resources about Web technologies. </p>

<p>Wikipedia skins for wiki are not excellent, it would be good if some skilled designers could experiment with a few skins too. </p>

<p>And last but not least, people also can create images for illustrating some concepts for some articles. Think for example about the CSS box model. :)</p>

<p>おめでとう Hiroki for starting the work, that's great!</p>

</div>
</div>


<div class="comment" id="comment-222888">
<p class="comment-meta" id="c222888">
<span class="comment-meta-author"><strong>Sudarshan Murthy </strong></span>
<span class="comment-meta-date"><a href="#c222888">#</a> 2011-04-05</span>
</p>
<div class="comment-bulk">
<p>This is a great idea. Thanks Hiroki for starting this project.</p>

<p>Karl, I hope you are right about this effort bringing vendor-neutral resources, but we need to be vigilant.</p>

</div>
</div>


<div class="comment" id="comment-222895">
<p class="comment-meta" id="c222895">
<span class="comment-meta-author"><strong>Hira Kumar Maharjan </strong></span>
<span class="comment-meta-date"><a href="#c222895">#</a> 2011-04-05</span>
</p>
<div class="comment-bulk">
<p>hi Hiroki, thanks for blog . I read it detail. You does great job. I am also working as WEB Accessiblity Compatiblity Web Design and Develop. I am more interested on your work. This would be nice step for beginner learning html with your html beginner lesson</p>

</div>
</div>


<div class="comment" id="comment-222904">
<p class="comment-meta" id="c222904">
<span class="comment-meta-author"><strong>karl dubost </strong></span>
<span class="comment-meta-date"><a href="#c222904">#</a> 2011-04-05</span>
</p>
<div class="comment-bulk">
<p>@sudarshan which kind of issues would you expect?
And what are your proposals to avoid them?</p>

</div>
</div>


<div class="comment" id="comment-222905">
<p class="comment-meta" id="c222905">
<span class="comment-meta-author"><strong>Hiroki Yamada </strong></span>
<span class="comment-meta-date"><a href="#c222905">#</a> 2011-04-05</span>
</p>
<div class="comment-bulk">
<p>@Karl<br />
Hi Karl, thank you for providing the additional information. I very much welcome anyone's joining to the editing work on this page.</p>

<p>@Sudarshan<br />
Hi Sudarshan, thanks for your comment. I will continue making documentation for other specifications.</p>

<p>@Hira<br />
Hi Hira, thank you for your comment. Please let me know if you have some advice for me.</p>

</div>
</div>


<div class="comment" id="comment-228081">
<p class="comment-meta" id="c228081">
<span class="comment-meta-author"><strong>nick </strong></span>
<span class="comment-meta-date"><a href="#c228081">#</a> 2011-05-16</span>
</p>
<div class="comment-bulk">
<p>hello, im very new to all this and find your comments interesting. i am starting a new web company in the uk, [redacted] and am wondering if there are any web designers that are w3c compliable that you could reccomend to me in the uk as your knowledge, i feel, is very great, many thanks.</p>

</div>
</div>


  <div class="comments-open" id="comments-open">
<h3 class="comments-open-header">Leave a comment</h3>

<div class="comments-open-moderated">
   <p>
   Note: this blog is intended to foster <strong>polite
   on-topic discussions</strong>. Comments failing these
   requirements and spam will not get published. Please,
   enter your real name and email address. Every
   individual comment is reviewed by the W3C staff.
   This may take some time, thank you for your patience.
   </p>
   <p>
   You can use the following HTML markup (a href, b, i,
   br/, p, strong, em, ul, ol, li, blockquote, pre)
   and/or <a href="http://daringfireball.net/projects/markdown/syntax">Markdown syntax</a>.</p>
</div>

<div id="comments-open-data">
<form method="post" action="http://www.w3.org/QA/sununga/beach.pl" id="comments-form">
<h4>Your comment</h4>
<div id="comments-open-text">
  <textarea id="comment-text" name="text" rows="20" cols="100"></textarea><br />
<label for="comment-text">Write your comment text here. Remember, keep the discussion on topic and courteous.</label>
</div>

<h4>About you</h4>
<div id="comment-form-name">
  <input type="hidden" name="static" value="1" />
<input type="hidden" name="entry_id" value="9053" />
<input type="hidden" name="__lang" value="en" />
<label for="comment-author">Your Name</label>
<input id="comment-author" name="author" size="30" value="" />
</div>
<div id="comment-form-email">
<label for="comment-email">Your Email Address</label>
<input id="comment-email" name="email" size="30" value="" />
</div>

<div id="comments-open-footer">
<input type="submit" accesskey="s" name="post" id="comment-submit" value="Submit" />

</div>
</form>
</div>
</div>


<p id="gentime">This page was last generated on $Date: 2011/12/16 03:00:14 $</p>

      </div><!-- End of "main" DIV. -->

<address>

This blog is written by W3C staff and working group participants,<br />
&nbsp;and maintained by <a href="/People/CMercier/">Coralie Mercier</a>.<br />
Authorized parties may <a href="/QA/new">log in</a> to create a new entry.<br/>
<span id="poweredby">Powered by Movable Type, magpierss and a lot of Web Technology</span>
    </address>


    <p class="copyright">
      <a rel="Copyright" href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a> &copy; 1994-2011
      <a href="http://www.w3.org/"><acronym title="World Wide Web Consortium">W3C</acronym></a>&reg;
      (<a href="http://www.csail.mit.edu/"><acronym title="Massachusetts Institute of Technology">MIT</acronym></a>,
      <a href="http://www.ercim.eu/"><acronym title="European Research Consortium for Informatics and Mathematics">ERCIM</acronym></a>,
      <a href="http://www.keio.ac.jp/">Keio</a>),
      All Rights Reserved.
      W3C <a href="http://www.w3.org/Consortium/Legal/ipr-notice#Legal_Disclaimer">liability</a>,
      <a href="http://www.w3.org/Consortium/Legal/ipr-notice#W3C_Trademarks">trademark</a>,
      <a rel="Copyright" href="http://www.w3.org/Consortium/Legal/copyright-documents">document use</a>
      and <a rel="Copyright" href="http://www.w3.org/Consortium/Legal/copyright-software">software licensing</a>
      rules apply. Your interactions with this site are in accordance
      with our <a href="http://www.w3.org/Consortium/Legal/privacy-statement#Public">public</a> and
      <a href="http://www.w3.org/Consortium/Legal/privacy-statement#Members">Member</a> privacy
      statements.
    </p>

  </body>
</html>