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 now, I'm working on
making the wiki-based documentation of W3C specifications at
W3C.
Background & Status
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.
I've finished developing two documents. The first document is
the
Educational
Materials for Beginners , and the second is the
List of HTML
Elements . However, these documents are just a first step for
this project, which is just beginning. We also have an
Open Web
Platform page. I will continue writing documentation for other
specifications that relate to the Open Web Platform.
In this entry, I explain three features of the documentation of
HTML.
HTML documentation's features
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.
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.
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
CSS Educational
Materials for Beginners, so people who study Web technology can
advance step by step from one level to the next.
I very much welcome bug reports and suggestions for improvements
by sending feedback to the publicly archived mailing list
public-webdev-docs@w3.org [
Web archive].