In the middle of things

So, I finally got my website up. It’s no big deal, some HTML with a few images and links, and I will do more later. I’d planned to use GoLive, which I got as part of Adobe CS, but became baffled as soon as I started the tutorial. They wanted me to make a Site Diagram and I tried, but couldn’t make it like the examples onscreen. I then went browsing for simple HTML references and was delighted to find this nice tutorial on the w3.org website.

I then went hunting in “view source” on other pages for examples of how to construct links and open new pages to display my samples… the challenge, in an era where everybody uses javascript or, I guess, tools like GoLive, was to find a site to emulate with an author whose vision was as modest as mine. And then I went back into GoLive to edit the whole thing for publication. But I still don’t know what a Site Diagram is for.

This brings to mind what a student in my class last week said is the characteristic of good documentation: it talks to the user about the process they are in the middle of. Or, in the case of the CSS tutorial mentioned above, it puts the user into the middle of something and gives them logical, easy steps to take that will pay back with satisfying and tangible results. I certainly did learn from the CSS tutorial, as you can see if you go to my site. And if anybody has a good GoLive book to recommend, or simply wants to explain Site Diagrams, please drop me a line.