- From: Ola Andersson <Ola.Andersson@ikivo.com>
- Date: Mon, 23 May 2005 11:33:27 +0200
- To: "Bjoern Hoehrmann" <derhoermi@gmx.net>
- Cc: <www-svg@w3.org>, <w3c-svg-wg@w3.org>
> -----Original Message----- > From: Bjoern Hoehrmann [mailto:derhoermi@gmx.net] > Sent: den 23 maj 2005 08:57 > To: Ola Andersson > Cc: www-svg@w3.org; w3c-svg-wg@w3.org > Subject: Re: SVG12: svgudom style > > * Ola Andersson wrote: > >> >I've now improved the styling of the udom appendix. Param names are > >> >highlighted, hyperlinks are added, return types are clearly listed, > >> >etc. In general I've choosen to follow the styling of the svg 1.1 > >> >DOM specification rather than the DOM3 specs since SVG1.2 readers > >> >are likely to be familiar with the older svg specifications. > > >IDL members does not link to member definitions. > > That's not acceptable to me then. This is a major usability concern, > without these links it is almost impossible to properly link to such > members from other web sites, discussions on IRC or mailing lists, > etc., and so it's often not done which means people refer to other > sources for the information (or no source at all) which yields in > fewer people properly understanding the specification, which can > hardly be intended here. You might not notice this problem if you > use the links only to navigate through the specification, but if you > participate in authoring fora this quickly becomes a concern. I see what you mean. For someone just reading the spec I think this is merely a nice-to-have but for the case you describe I can see the need for it. However, the tool we use for generating the udom is not easily extendable to cater for this. (and we're not using xmlspec). Even if the svg WG will not be able to address this in the SVGT1.2 version of the spec it will be strongly considered for the following version. Thanks /ola > -- > Björn Höhrmann · mailto:bjoern@hoehrmann.de · http://bjoern.hoehrmann.de > Weinh. Str. 22 · Telefon: +49(0)621/4309674 · http://www.bjoernsworld.de > 68309 Mannheim · PGP Pub. KeyID: 0xA4357E78 · http://www.websitedev.de/
Received on Monday, 23 May 2005 09:33:38 UTC