Re: [xsl] Attribute order recommendations

Subject: Re: [xsl] Attribute order recommendations
From: "Gayanthika Udeshani gudeshani@xxxxxxxxxx" <xsl-list-service@xxxxxxxxxxxxxxxxxxxxxx>
Date: Tue, 25 Aug 2020 08:35:49 -0000
we also follow the same order as Michael described, it is easy when we
define an order for the team you work with.

On Tue, Aug 25, 2020 at 1:55 PM Damian Morris damian@xxxxxxxxxxx <
xsl-list-service@xxxxxxxxxxxxxxxxxxxxxx> wrote:

> 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
>
>
> I tend to follow the same approach as Michael describes when crafting APIs
> in general, but also in placing attributes in particular.
>
>
>
> On 25 Aug 2020, at 6:14 pm, Michael Kay mike@xxxxxxxxxxxx <
> xsl-list-service@xxxxxxxxxxxxxxxxxxxxxx> wrote:
>
> 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/
>
> 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)
>
>
> XSL-List info and archive <http://www.mulberrytech.com/xsl/xsl-list>
> EasyUnsubscribe <http://lists.mulberrytech.com/unsub/xsl-list/1106500> (by
> email <>)

Current Thread