[xquery-talk] XQuery Style Conventions

[Frank Cohen]

Darin's already seen then and I thought the rest of the group my  
benefit too. -Frank

--


1) This is excellent work. It's great to see you codifying good  
practices in the XQuery world.

2) Section 2.1 seems to need some more definition of how to represent  
the supported specification. For example, how would I say that a  
module needs the April 2005 Final Candidate specification?

3) Also Section 2.1, I love the entry "Proprietary XQuery Extensions  
Used:" That makes so much sense!

4) 3 on Indentation. I would prefer to see that indentation is 1)  
required and 2) always of an equal number of spaces (or tabs) rather  
than saying it is "a unit of 4 spacees." Let those silly people using  
10 spaces to indent have their donut and eat it too.

5) Section 4.2, why not just incorporate the xqDoc documenting into  
this document? It seems like a natural to me.

6) Perhaps there should be an Appendix C noting poorly styled XQuery?


--



On Oct 21, 2005, at 6:53 AM, McBeath, Darin W (ELS-AMS) wrote:


> Here is a version of the XQuery Style Conventions in PDF format.
>
>
>
> http://xqdoc.org/xquery-style.pdf
>
>
>
> Thanks for the feedback to date.
>
>
>
> Darin.
>
> _______________________________________________
> talk at xquery.com
> http://xquery.com/mailman/listinfo/talk
>