Wiki-based documentation project

Part of Tools

Author(s) and publish date

Skip to 6 comments

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 [Web archive].

Related RSS feed

Comments (6)

Comments for this post are closed.