The online DRM is due for a radical HTML cleanup
The online DRM is due for a radical HTML cleanup. It was
machine-generated and contains a lot of cruft. I've spent a lot of time
fixing the outright HTML errors, cleaning up hundreds of incorrect
translations that made it unreadable in places, and adjusting the
formatting -- using CSS -- to match the printed DRM.
While doing that, I tried to keep the HTML fairly close to the original.
Being machine-generated, it contains a lot of "information", in the
abstract sense, like redundant tags and anchors that reflect something
about the original document format, but which aren't strictly necessary
for the HTML. Furthermore, many of the links and anchors don't really
make for great browsing. For example, a lot of the links take you to the
first paragraph after a header that describes the topic. Instead, they
should link to the header.
Up to this point I left most of this alone, in an effort to not strip
out any information that might be useful in the future. However, now
that the outright errors are fixed and backed up in the source
repository, I'd like to go ahead and make more radical changes. I'd like
to
- clean up the links and anchors so browsing makes more sense,
- change numeric anchors to something mnemonic, which would make it
easier to maintain, and the URLs would be more meaningful to humans,
- delete redundant tags and anchors,
- delete any vestiges of presentation-specific tagging and make sure all
the formatting is in the CSS.
Unless there are objections, I'll start on this as soon as I have time.
Also, feel free to let me know if you have any suggestions for
improvements to the online DRM (however, I won't be making any changes
to the DRM content, not even to fix typos -- we can discuss doing that
in the future, and we probably need to confer with Andrew Shalit first).
NOTE: The link between comp.lang.dylan and the info-dylan email list is
broken. Please reply to Usenet.
--
Chris Page - Software Wrangler - Dylan Pundit
Open Source Dylan Compilers: <http://www.gwydiondylan.org/>
Dylan Blogging: <http://homepage.mac.com/chrispage/iblog/>
Dylan Stuff: <http://cafepress.com/chrispage>
|