Do we need style coding guidelines?

CSL Evolution
1

In two recent discussions (this and that) there was the question of encouraging certain coding conventions to make data more style independent. Shouldn’t there be some guidelines about that?

2

I agree. This post by Sebastian would be a good start for such things: https://zoteromusings.wordpress.com/2013/10/28/writing-csl-features-and-best-practices/

3

Yeah, something like this.
Perhaps as an appendix here?

4

I don’t think it belongs in the spec; does it?

Maybe simply published alongside it?

And yeah, Sebastian’s post is an excellent start.

5

No, not really in the spec.
Alongside is good. But it should be clear that there are some explicit expectations so that users can rely on these things.

6

Can include a link to it from the spec?

7

Yes, would be ok. But where should we have these recommendations.

8

What about having a section on citationstyles.org? Like this section?

1 Like