[XSL-LIST Mailing List Archive Home] [By Thread] [By Date] [Recent Entries] [Reply To This Message]

Re: Attribute order recommendations

Subject: Re: Attribute order recommendations
From: "Michael Kay mike@xxxxxxxxxxxx" <xsl-list-service@xxxxxxxxxxxxxxxxxxxxxx>
Date: Tue, 25 Aug 2020 08:14:41 -0000
Re:  Attribute order recommendations
I can't say I share the author's admiration for Chekhov. When I watch a
Chekhov play, I'm usually sitting there wishing the characters would just get
on with the action and cut out the small talk.

Yes, Serhiy is right, consistency in naming is useful, and consistency is also
useful in other aspects of coding. But I'm not sure there are any "right
answers" as to what conventions are best.

I think my instinct with attributes is to put them in order of rarity: the
most common attributes first, then the less common ones. So I tend to write

<xsl:param name="p" as="xs:integer" select="0"  tunnel="yes"/>

But asking someone else to do the same is a bit like asking them to change
their handwriting to match yours; I'm not sure it's well-spent effort.
However, I wouldn't object to an IDE that regularises the attribute order to
match project-level settings.

Michael Kay
Saxonica



> On 25 Aug 2020, at 08:45, Michael MC<ller-Hillebrand mmh@xxxxxxxxx
<xsl-list-service@xxxxxxxxxxxxxxxxxxxxxx> wrote:
>
> Folks,
>
> Understanding XSLT as quick as possible is important. This blog post with
the motto "Spare the maintainer" impressed me some years ago:
https://blog.xml.rocks/xslt-naming-conventions/
<https://blog.xml.rocks/xslt-naming-conventions/>
>
> But what about attribute order conventions?
>
> I started putting the typing attribute as="b&" at the end of e.g.
xsl:variable, xsl:function or xsl:param.
>
> But then I meet tunnel="yes", shall I put it before as="b&" or at the very
end, to make it more obvious to the casual observer?
>
> Also, in a recent post by Graydon Saunders I notice as="b&" as the very
first attribute on every xsl:variable, even before name="b&" which also makes
sense to me somehow.
>
> Have I missed some insightful source/post, or can we discuss the benefits of
attribute order conventions?
>
> - Michael MC<ller-Hillebrand
>
> XSL-List info and archive <http://www.mulberrytech.com/xsl/xsl-list>
> EasyUnsubscribe <http://lists.mulberrytech.com/unsub/xsl-list/293509> (by
email <>)

Current Thread

PURCHASE STYLUS STUDIO ONLINE TODAY!

Purchasing Stylus Studio from our online shop is Easy, Secure and Value Priced!

Buy Stylus Studio Now

Download The World's Best XML IDE!

Accelerate XML development with our award-winning XML IDE - Download a free trial today!

Don't miss another message! Subscribe to this list today.
Email
First Name
Last Name
Company
Subscribe in XML format
RSS 2.0
Atom 0.3
Site Map | Privacy Policy | Terms of Use | Trademarks
Free Stylus Studio XML Training:
W3C Member
Stylus Studio® and DataDirect XQuery ™are products from DataDirect Technologies, is a registered trademark of Progress Software Corporation, in the U.S. and other countries. © 2004-2013 All Rights Reserved.