Miro:



Course objectives
Textbooks
Course policies
Grading plan
Quizlog checker
Gradebook
Course resources
Class e-mail
Chatroom
FAQs

Week of:
July 5
July 12
July 19
July 26
August 2

Course Overview

This workshop-style course introduces XML and related technologies focusing on their application in business, government, and technical communications. In addition to an overview of the raw materials needed to create and transform XML (DTDs, schemas, XSL and CSS stylesheets), the course introduces you to industry-standard solutions such as DocBook, DITA and the related tools, both commercial and open source. You learn to create and validate XML documents and to transform them into a variety of output formats (HTML, CHM, PDF, RTF, MIF). You also learn the origins and evolution of SGML and XML and how to evaluate the appropriateness of an XML-based solution for various situations you might encounter as professionals.

See the Course Calendar for a calendar-style view of semester due dates.

Instructor: David A. McMurrey
Class meetings: Online-only course at Austin Community College
Office: Northridge 4225
Office hours: Mon/Wed. 12:00 - 4:00 p.m., and by apptmt. (Always call before driving all the way out to Northridge Campus.)
Phone: 512-223-4804
E-mail: hcexres@io.com

The following schedule shows how this course has been taught in the past. Course content, objectives, and assignments will vary according to the current instructor.

See the Course Calendar for a calendar-style view of semester due dates.

Week of July 5

This course is for people who have created web pages using HTML, are familiar with the requirements for using XHTML, and know how to use CSS. You don't have to have all HTML, XHTML, and CSS memorized—just be able to look things up quickly. This course moves you into the essentials of XML and related topics and has you do some projects similar to what technical writers get involved in.

Background on XML. Do introductory readings from as many of the sources listed in the project page as you have time for or can get your hands on. In the project for this unit, as succinctly and clearly as possible, you write brief discussions of essential XML concepts.

Introduction to XML markup. Get an introduction to the essentials of XML structure and markup, and create the XML markup for a very simple document and another for a less simple document.

Readings in technical communication. The readings and reading quizzes listed here are for general background and may not directly relate to this week's projects.

    Readings: ReadMe 9 (document types)
    ReadMe 10 (editors)
    Activities & due date: ReadMe 9 Quizdue July 11
    ReadMe 10 Quizdue July 11

Week of July 12

Introduction to DTDs. Learn the basic building blocks of DTDs and be able either to describe the rules established by a simple DTD or to create your own simple DTD. And then do one of the following (or both!): describe the requirement in a simple DTD in understandable English; or create your own simple DTD (for example, based on one of the preceding XML documents you created).

    Readings: See the XML section of Course Resources for recommendations.
    Activities & due date: DTD practicedue July 18

XML-CSS project. Create a document that depends on an XML file and an CSS file. In other words, the XML file defines the valid structure of your document, and the CSS file specifies the format and style (the appearance) of your document.

    Readings: See the XML and CSS sections of Course Resources for recommendations.
    Activities & due date: XML-CSS projectdue July 18

(Optional) XML files as databases. Learn how to "bind" the data contained in an XML file to an HTML that is structured to display that data but contains no data itself. Learn also how that data displayed in the HTML document can be scrolled.

(Optional) Introduction to XSLT and schemas. Get an introduction to two powerful but still emerging tools that you can use to specify presentational characteristics of XML documents as well as to transform them in other useful ways. (The tutorial for this unit includes a guided project that you complete and post to your website.)

    Readings: See the XML section of Course Resources for recommendations.
    Activities & due date: XSLT practice

Readings in technical communication. The readings and reading quizzes listed here are for general background and may not directly relate to this week's projects.

Week of July 19

XML: DocBook and editing tools. Get some experience with one of the most popular DTDs—DocBook. Get some experience with popular applications (some of which are shareware) that facilitate working with XML such as XMetaL, XML Spy, and Epic. (The tutorial for this unit includes a guided project that you complete and post to your website.)

XML formatting/design project. Using an XML-authoring tool, DocBook, and text and graphics provided, create a fully valid XML-based document.

Readings in technical communication. The readings and reading quizzes listed here are for general background and may not directly relate to this week's projects.

Week of July 26

Task analysis. Learn or review the basics of identifying user tasks related to a product and then structuring a documentation project accordingly. (If you have already done this unit and taken the quiz earlier this semester or in a previous course, you can skip this unit.)

    Readings: Task analysis: learn or review the basics of identifying user tasks related to a product and then structuring a documentation project accordingly.
    Activities & due date: Task-analysis quizdue August 1

Page design: review. Review page design for the standard design guidelines for headings, lists, notices, tables, figures, cross-references, and highlighting. (If you have already done this unit and taken the quiz earlier this semester or in a previous course, you can skip this unit.)

    Readings: Page design: review guidelines for headings, lists, notices, and highlighting.
    Activities & due date: page-design quizdue August 1

Multiple outputs with XML. Use the directions and resources provided in this unit to output XML source to three media (HTML, PDF, and helps). (The tutorial for this unit includes a guided project that you complete and post to your website.)

    Readings: See the XML section of Course Resources for recommendations.
    Activities & due date: XML-outputs practicedue August 1 (Click the conversion link and convert workshop2.xml to PDF, HTML, and any Word format. Post these files on your website.)

Optional: XML and interactive forms. Learn how to store data collected from HTML forms into XML files. (The tutorial for this unit includes a guided project that you complete and post to your website.)

    Readings: See the XML section of Course Resources for recommendations.
    Activities & due date: XML-forms practice

Readings in technical communication. The readings and reading quizzes listed here are for general background and may not directly relate to this week's projects.

    Readings: ReadMe A (publications departments)
    Activities & due date: ReadMe A Quizdue July 25

Week of August 2

Final XML project. All on your own now, develop an original documentation project of your own that uses a DTD, a presentation tool (CSS, Schema, XSLT). Set this project up so that you can and do generate three outputs (HTML, PDF, and .chm). This is the one you show off!

    Readings: See the XML section of Course Resources for recommendations.
    Activities & due date: Final XML projectdue August 8





Information and programs provided hcexres@io.com.