# Time frame for completion of CSL 1.0?

**URL:** <https://discourse.citationstyles.org/t/time-frame-for-completion-of-csl-1-0/796>\
**Category:** CSL Development\
**Created:** [December 3, 2009, 12:54pm UTC](https://discourse.citationstyles.org/t/time-frame-for-completion-of-csl-1-0/796 "2009-12-03T12:54:34Z")\
**Posts on this page:** 12\
**Page:** 1

<div class="post-metadata">

**Author:** ![Frank\_Bennett](https://yyz1.discourse-cdn.com/flex029/user_avatar/discourse.citationstyles.org/frank_bennett/32/198_2.png) [@Frank\_Bennett](https://discourse.citationstyles.org/u/Frank_Bennett)\
**Post date:** [December 3, 2009, 12:54pm UTC](https://discourse.citationstyles.org/t/time-frame-for-completion-of-csl-1-0/796/1 "2009-12-03T12:54:34Z")

</div>

I don’t think we’ve set a revised target for the completion of CSL 1.0.

Shall we do that?

---

<div class="post-metadata">

**Author:** ![Rintze\_Zelle](https://yyz1.discourse-cdn.com/flex029/user_avatar/discourse.citationstyles.org/rintze_zelle/32/175_2.png) [@Rintze\_Zelle](https://discourse.citationstyles.org/u/Rintze_Zelle)\
**Post date:** [December 3, 2009, 1:40pm UTC](https://discourse.citationstyles.org/t/time-frame-for-completion-of-csl-1-0/796/2 "2009-12-03T13:40:44Z")

</div>

I think we need two milestones. The first would be 1.0RC2 (feature-freeze).  
The second one would be 1.0 final, which should preferably coincide with the  
release of updated documentation (specification & upgrade notes).

I wouldn’t mind updating the docs, but I’ll probably need 4-6 weeks to  
(re)write everything after RC2 has been tagged (I happen to be quite busy 🙂  
).

Rintze

---

<div class="post-metadata">

**Author:** ![Andrea\_Rossato1](https://avatars.discourse-cdn.com/v4/letter/a/e47774/32.png) [@Andrea\_Rossato1](https://discourse.citationstyles.org/u/Andrea_Rossato1)\
**Post date:** [December 3, 2009, 1:45pm UTC](https://discourse.citationstyles.org/t/time-frame-for-completion-of-csl-1-0/796/3 "2009-12-03T13:45:37Z")

</div>

Just to let you know that I started working on the Haskell  
implementation again, after a long stop. I’m finishing with the  
implementation of everything needed by the test suite - BTW, Frank,  
you did really a great job!

When the tests will be working (very soon since I just need to write  
the HTML formatter for the output, now) I’ll update everything and  
implement what’s still missing. So, if we set a target I’ll try to  
comply with it.

Just a question: is the “input” array in the JSON test object meant to  
be a reference API, for instance with regards to name structures? The  
citations object could be a reference API too, for citation prefixes,  
modifiers and locators. I saw a thread above about something like  
this, but I must confess that catching up with the discussions of the  
last 6 month is hard… 😉

Nice job, though, even if it makes mine quite challenging.

Andrea

---

<div class="post-metadata">

**Author:** ![Bruce\_D\_Arcus1](https://avatars.discourse-cdn.com/v4/letter/b/4bbf92/32.png) [@Bruce\_D\_Arcus1](https://discourse.citationstyles.org/u/Bruce_D_Arcus1)\
**Post date:** [December 3, 2009, 2:25pm UTC](https://discourse.citationstyles.org/t/time-frame-for-completion-of-csl-1-0/796/4 "2009-12-03T14:25:55Z")

</div>

Yeah, me too. I will have some time over the holiday break, but am not  
sure how much.

How about we say Jan 31 for RC2, and March 1 for final?

Is that sensible, or too conservative?

Bruce

---

<div class="post-metadata">

**Author:** ![Frank\_Bennett](https://yyz1.discourse-cdn.com/flex029/user_avatar/discourse.citationstyles.org/frank_bennett/32/198_2.png) [@Frank\_Bennett](https://discourse.citationstyles.org/u/Frank_Bennett)\
**Post date:** [December 3, 2009, 2:36pm UTC](https://discourse.citationstyles.org/t/time-frame-for-completion-of-csl-1-0/796/5 "2009-12-03T14:36:20Z")

</div>

Good to see you again, Andrea.

> > I don’t think we’ve set a revised target for the completion of CSL 1.0.
> > 
> > Shall we do that?
> 
> Just to let you know that I started working on the Haskell  
> implementation again, after a long stop. I’m finishing with the  
> implementation of everything needed by the test suite - BTW, Frank,  
> you did really a great job!

Let’s hope it works. 🙂

> When the tests will be working (very soon since I just need to write  
> the HTML formatter for the output, now) I’ll update everything and  
> implement what’s still missing. So, if we set a target I’ll try to  
> comply with it.
> 
> Just a question: is the “input” array in the JSON test object meant to  
> be a reference API, for instance with regards to name structures? The  
> citations object could be a reference API too, for citation prefixes,  
> modifiers and locators.

The specific structures in the tests (and in the citeproc-js manual at  
[http://gsl-nagoya-u.net/http/pub/citeproc-doc.html](http://gsl-nagoya-u.net/http/pub/citeproc-doc.html)) haven’t been  
agreed as a CSL-wide API. They are just my own idea of what seemed  
workable as I was putting things together in the processor. There’s  
not a requirement that the processor accept these specific JSON  
structures as far as I know.

In fact, the interface for the citation object is about to change,  
from Monday next week or so. The twinned arrays will be collapsed  
into a single JS object, with the string representing the ID moved  
inside it as an “id” field.

Despite this change, things are pretty quiet now, both with CSL and  
with the citeproc-js code.

> I saw a thread above about something like  
> this, but I must confess that catching up with the discussions of the  
> last 6 month is hard… 😉
> 
> Nice job, though, even if it makes mine quite challenging.

There are lots of twists and turns lurking in the specification. Post  
if you run into issues, I should at least be able to describe whatever  
solution I came up with.

---

<div class="post-metadata">

**Author:** ![Frank\_Bennett](https://yyz1.discourse-cdn.com/flex029/user_avatar/discourse.citationstyles.org/frank_bennett/32/198_2.png) [@Frank\_Bennett](https://discourse.citationstyles.org/u/Frank_Bennett)\
**Post date:** [December 3, 2009, 2:47pm UTC](https://discourse.citationstyles.org/t/time-frame-for-completion-of-csl-1-0/796/6 "2009-12-03T14:47:25Z")

</div>

> > I think we need two milestones. The first would be 1.0RC2 (feature-freeze).  
> > The second one would be 1.0 final, which should preferably coincide with the  
> > release of updated documentation (specification & upgrade notes).
> > 
> > I wouldn’t mind updating the docs, but I’ll probably need 4-6 weeks to  
> > (re)write everything after RC2 has been tagged (I happen to be quite busy 🙂  
> > ).
> 
> Yeah, me too. I will have some time over the holiday break, but am not  
> sure how much.
> 
> How about we say Jan 31 for RC2, and March 1 for final?
> 
> Is that sensible, or too conservative?

+1 for sensibly conservative

---

<div class="post-metadata">

**Author:** ![Rintze\_Zelle](https://yyz1.discourse-cdn.com/flex029/user_avatar/discourse.citationstyles.org/rintze_zelle/32/175_2.png) [@Rintze\_Zelle](https://discourse.citationstyles.org/u/Rintze_Zelle)\
**Post date:** [February 21, 2010, 9:25pm UTC](https://discourse.citationstyles.org/t/time-frame-for-completion-of-csl-1-0/796/7 "2010-02-21T21:25:50Z")

</div>

Just to give you guys a heads-up. I went through the upgrade notes, spec and  
schema, and all three have been cleaned up and made up to date. The spec is  
still missing a few details with regards to sorting, the display attribute  
and disambiguation, but Frank agreed to fill those in when he finds the time  
(being the disambiguation expert and all).

I’ll probably go through all of it once more to check everything’s there,  
but I think we’re getting close to the event horizon of CSL 1.0. This might  
be a good time for comments on the documentation before we call 1.0 final.

Rintze

---

<div class="post-metadata">

**Author:** ![Bruce\_D\_Arcus1](https://avatars.discourse-cdn.com/v4/letter/b/4bbf92/32.png) [@Bruce\_D\_Arcus1](https://discourse.citationstyles.org/u/Bruce_D_Arcus1)\
**Post date:** [February 22, 2010, 2:52pm UTC](https://discourse.citationstyles.org/t/time-frame-for-completion-of-csl-1-0/796/8 "2010-02-22T14:52:34Z")

</div>

Awesome!

Do you want to give a deadline for these comments?

Bruce

---

<div class="post-metadata">

**Author:** ![Rintze\_Zelle](https://yyz1.discourse-cdn.com/flex029/user_avatar/discourse.citationstyles.org/rintze_zelle/32/175_2.png) [@Rintze\_Zelle](https://discourse.citationstyles.org/u/Rintze_Zelle)\
**Post date:** [February 22, 2010, 3:14pm UTC](https://discourse.citationstyles.org/t/time-frame-for-completion-of-csl-1-0/796/9 "2010-02-22T15:14:34Z")

</div>

That partially depends on how busy you are :). We can still make our target  
of March 1st, but maybe it’s better to take a bit more time to iron out any  
bugs in the schema and unclarities in the spec. I still have to check  
whether upgrade.xls works properly for the current draft, and CSL 1.0 locale  
files need to be generated (using the data in the 0.8 locale files). It  
might also be nice if citeproc-js supports CSL 1.0 at launch.

So how about 2 weeks (i.e. March 8th)? If all goes smoothly we can then call  
1.0 a week or so later.

Rintze

---

<div class="post-metadata">

**Author:** ![Bruce\_D\_Arcus1](https://avatars.discourse-cdn.com/v4/letter/b/4bbf92/32.png) [@Bruce\_D\_Arcus1](https://discourse.citationstyles.org/u/Bruce_D_Arcus1)\
**Post date:** [February 22, 2010, 3:29pm UTC](https://discourse.citationstyles.org/t/time-frame-for-completion-of-csl-1-0/796/10 "2010-02-22T15:29:27Z")

</div>

Sounds good to me.

Bruce

---

<div class="post-metadata">

**Author:** ![Rintze\_Zelle](https://yyz1.discourse-cdn.com/flex029/user_avatar/discourse.citationstyles.org/rintze_zelle/32/175_2.png) [@Rintze\_Zelle](https://discourse.citationstyles.org/u/Rintze_Zelle)\
**Post date:** [February 27, 2010, 1:24pm UTC](https://discourse.citationstyles.org/t/time-frame-for-completion-of-csl-1-0/796/11 "2010-02-27T13:24:52Z")

</div>

Another short update: with the [locale.sh](http://locale.sh) and [update-styles.sh](http://update-styles.sh) scripts  
available at [http://bitbucket.org/bdarcus/csl-utils/](http://bitbucket.org/bdarcus/csl-utils/), I’ve generated CSL 1.0  
locale files ([http://bitbucket.org/bdarcus/csl-locales/src/tip/trunk/](http://bitbucket.org/bdarcus/csl-locales/src/tip/trunk/)) and  
CSL 1.0 styles (  
[http://citationstyles.org/downloads/csl-styles-1.0-2010-2-27.zip.gz](http://citationstyles.org/downloads/csl-styles-1.0-2010-2-27.zip.gz)). The  
locale files are based on the CSL 0.8 locale files from the Zotero SVN  
(which I copied to  
[http://bitbucket.org/bdarcus/csl-locales/src/tip/branches/0.8/](http://bitbucket.org/bdarcus/csl-locales/src/tip/branches/0.8/)), whereas the  
styles are based on a snapshot of the Zotero Style Repository (  
[http://citationstyles.org/downloads/csl-styles-0.8.1-2010-2-27.zip.gz](http://citationstyles.org/downloads/csl-styles-0.8.1-2010-2-27.zip.gz)). I  
had to make some manual adjustments to a select number of styles (  
[https://www.zotero.org/trac/changeset/5797](https://www.zotero.org/trac/changeset/5797)), but at the moment the entire  
repository can be automatically converted.

Rintze

---

<div class="post-metadata">

**Author:** ![Frank\_Bennett](https://yyz1.discourse-cdn.com/flex029/user_avatar/discourse.citationstyles.org/frank_bennett/32/198_2.png) [@Frank\_Bennett](https://discourse.citationstyles.org/u/Frank_Bennett)\
**Post date:** [February 27, 2010, 8:26pm UTC](https://discourse.citationstyles.org/t/time-frame-for-completion-of-csl-1-0/796/12 "2010-02-27T20:26:37Z")

</div>

> Another short update: with the locale.sh and update-styles.sh scripts  
> available at [http://bitbucket.org/bdarcus/csl-utils/](http://bitbucket.org/bdarcus/csl-utils/), I’ve generated CSL 1.0  
> locale files ([http://bitbucket.org/bdarcus/csl-locales/src/tip/trunk/](http://bitbucket.org/bdarcus/csl-locales/src/tip/trunk/)) and  
> CSL 1.0 styles  
> ([http://citationstyles.org/downloads/csl-styles-1.0-2010-2-27.zip.gz](http://citationstyles.org/downloads/csl-styles-1.0-2010-2-27.zip.gz)). The  
> locale files are based on the CSL 0.8 locale files from the Zotero SVN  
> (which I copied to  
> [http://bitbucket.org/bdarcus/csl-locales/src/tip/branches/0.8/](http://bitbucket.org/bdarcus/csl-locales/src/tip/branches/0.8/)), whereas the  
> styles are based on a snapshot of the Zotero Style Repository  
> ([http://citationstyles.org/downloads/csl-styles-0.8.1-2010-2-27.zip.gz](http://citationstyles.org/downloads/csl-styles-0.8.1-2010-2-27.zip.gz)). I  
> had to make some manual adjustments to a select number of styles  
> ([https://www.zotero.org/trac/changeset/5797](https://www.zotero.org/trac/changeset/5797)), but at the moment the entire  
> repository can be automatically converted.

Congrats! Splendid work.
