RE: Request for assistance: editing use case & requirements document

Hi Davide & Eric ... many thanks for your offer of help.

Later this evening (after I've got back from a run :-) ) I plan to review the use cases in the wiki to identify which are in a good state for transfer to the use case and requirements (UCR) doc. I'll provide my thoughts on that ASAP. Then we can each grab some to edit into the UCR doc.

OK ... working practices.

The source document is at github:w3C/csvw/use-cases-and-requirements/index.html

Because we're using Github pages, the main branch we're using is gh-pages.

My preference, at least initially, would be for you to branch gh-pages and send me pull requests? Are you ok with that?

Points to note:
* You'll see that we're using W3C Respec for the document, there's a user guide <http://www.w3.org/respec/guide.html> but I think it should be fairly self evident to follow the pattern of the use cases I've added already.
* I'm dumping the supporting files straight into the use-cases-and-requirements/ directory, so please make the file names unique :-)
* If you can help it, please try to avoid "prettifying" the html as we may adversely impact each other (difficult to merge).
* I am maintaining bi-directional links between use cases and requirements (Requires: and Motivation:) - please can you keep these up to date.
* Put new requirements in the "candidate requirements" section until we've approved them
* Please follow the pattern I've started for the use-case and requirement fragment identifiers; human readable please!

Finally, don't forget to add yourselves as EDITORS!

Many thanks, Jeremy 

-----Original Message-----
From: Ceolin, D. [mailto:d.ceolin@vu.nl] 
Sent: 24 February 2014 18:09
To: Eric Stephan
Cc: Tandy, Jeremy; W3C CSV on the Web Working Group
Subject: Re: Request for assistance: editing use case & requirements document

Me too.

Davide

Il giorno 24/feb/2014, alle ore 18.05, Eric Stephan ha scritto:

> Hi Jeremy,
> 
> I can help, let me know what I can do.
> 
> Eric
> 
> On Mon, Feb 24, 2014 at 2:10 AM, Tandy, Jeremy 
> <jeremy.tandy@metoffice.gov.uk> wrote:
>> Hi all -
>> 
>> 
>> 
>> The use case document is now well underway, hopefully we can see 
>> where that's heading.
>> 
>> 
>> 
>> Looking at my calendar for the next 4 weeks, I have less time to 
>> contribute to the editorial ... and I note the timescales identified 
>> by Jeni and danbri at our first telcon which indicated the milestone 
>> for first public working draft for March - with an initial draft for end Feb.
>> 
>> 
>> 
>> So ... there are two options:
>> 
>> i)                    More offers of assistance to edit the document - I
>> think that we can probably partition the use cases from the wiki.
>> 
>> ii)                   We push the timelines
>> 
>> 
>> 
>> Here's hoping for option #1
>> 
>> 
>> 
>> Jeremy
> 

Received on Tuesday, 25 February 2014 17:22:16 UTC