W3C home > Mailing lists > Public > public-dxwg-wg@w3.org > January 2018

RE: Requirements --> GitHub issues

From: Jaroslav Pullmann <jaroslav.pullmann@fit.fraunhofer.de>
Date: Fri, 19 Jan 2018 11:24:24 +0100
To: Simon.Cox@csiro.au, alejandra.gonzalezbeltran@oerc.ox.ac.uk
Message-ID: <73da-5a61c780-1f-71b1aa80@261952703>
Cc: public-dxwg-wg@w3.org

   Hello Alejandra, hello Simon, 

     happy to see this bit of work helped! My credentials go to the W3 XSLT WG and Michael Kay, the author of the one and only up-to-date Saxon XSLT processor [1]. 
   As suggested by Alejandra I uploaded the script and a short howto in GitHub  [2] . By the way, I got stuck in Berlin because of a hurricane [3] which helped keeping other tasks at bay ;o)

   Best regards 
  Jaro 

  [1] https://www.saxonica.com/download/java.xml
  [2] https://github.com/w3c/dxwg/tree/gh-pages/utils/req2issue
  [3] https://www.thelocal.de/20180117/storm-friederike-forecast-to-bring-hurricane-force-winds-to-germany

On Friday, January 19, 2018 00:30 CET, <Simon.Cox@csiro.au> wrote: 
 
> Thanks a lot Jaro. 
> That will allow us to proceed with DCAT work with consistent record-keeping. Super. 
> 
> Simon 
> 
> -----Original Message-----
> From: Jaroslav Pullmann [mailto:jaroslav.pullmann@fit.fraunhofer.de] 
> Sent: Friday, 19 January, 2018 08:26
> To: Cox, Simon (L&W, Clayton) <Simon.Cox@csiro.au>; Alejandra Gonzalez-Beltran <alejandra.gonzalezbeltran@oerc.ox.ac.uk>
> Cc: Rob Atkinson <rob@metalinkage.com.au>; public-dxwg-wg@w3.org
> Subject: Re: Requirements --> GitHub issues
> 
> 
>   Dear Alejandra, dear Simon, 
> 
>     I am done,  the requirements have been ported [1] using their original, slightly augmented structure. 
>   As mentioned, my hope is to let them evolve and some day become re-imported into the UCR document. 
>   The automatically added labels may cover multiple deliverables (due to inheritance from multiple related UCs)
>   and are still gray demanding some colors..
> 
>   Best regards
>    Jaro 
> 
>   [1] https://github.com/w3c/dxwg/issues/
> 
> On Thursday, January 18, 2018 09:30 CET, "Jaroslav Pullmann" <jaroslav.pullmann@fit.fraunhofer.de> wrote: 
>  
> > 
> >   Dear Alejandra,
> > 
> >      thank you, there are no real challenges, but time. I am now blocked in a full day meeting and will resume tomorrow. 
> >    My idea was to port the whole requirement <section> making GitHub issue tracker an intermediate, rich editor. This  would 
> >    allow re-importing into the UCR document. My little testing was positive - GithHub REST API really easy to use, the issue
> >    editor accepts, displays and persists rich HTML content:
> > 
> >         https://github.com/w3c/dxwg/issues/51
> >         https://api.github.com/repos/w3c/dxwg/issues/51
> > 
> >    Would you agree to proceed in this way?
> >     Best regards
> >   Jaro
> >  
> > On Wednesday, January 17, 2018 22:17 CET, Alejandra Gonzalez-Beltran <alejandra.gonzalezbeltran@oerc.ox.ac.uk> wrote: 
> >  
> > > Hi Jaro,
> > > 
> > > It's great that you're looking into the automated creation of issues 
> > > for each of the requirements.
> > > 
> > > In case you are also looking at the tagging, I have added labels for > each of the requirements' categories:
> > > 
> > > https://github.com/w3c/dxwg/labels
> > > 
> > > Let us know how you get on.
> > > 
> > > Best wishes,
> > > 
> > > Alejandra
> > > 
> > > 
> > > On 17/01/2018 15:25, Jaroslav Pullmann wrote:
> > > >    Hello Simon,  hello Rob
> > > >
> > > >      thank you, the example is really useful! I've entered a long distance train, a reason I'll probably miss today's DCAT call
> > > >    but a chance to dedicate time on the requirement conversion.  As mentioned by Rob, the GitHub REST API is the right tool
> > > >    (which I have to familiarize with first). The import should be done by Friday/next Monday.
> > > >
> > > >     Best regards
> > > >   Jaro
> > > >
> > > >
> > > > On Wednesday, January 17, 2018 07:14 CET, Rob Atkinson <rob@metalinkage.com.au> wrote:
> > > >   
> > > >> Was hoping that Jaro would be able to adapt his scripts to pump 
> > > >> out all the issues to github via the REST api :-)
> > > >>
> > > >> rob
> > > >>
> > > >>
> > > >> On Wed, 17 Jan 2018 at 16:15 <Simon.Cox@csiro.au> wrote:
> > > >>
> > > >>> OK folk, I broke down and did one manually to illustrate what I 
> > > >>> was hoping could be done automatically.
> > > >>>
> > > >>>
> > > >>>
> > > >>> https://github.com/w3c/dxwg/issues/50 corresponds to 
> > > >>> https://www.w3.org/TR/dcat-ucr/#RDID
> > > >>>
> > > >>>
> > > >>>
> > > >>> I copied the link to the UCR document into the issue.
> > > >>>
> > > >>> I gave it the following labels
> > > >>>
> > > >>> (i)                  [requirement]
> > > >>>
> > > >>> (ii)                [dcat] according to the deliverable-related tag
> > > >>> inherited from Use Case that generated the requirement
> > > >>>
> > > >>>
> > > >>>
> > > >>> Putting it in a standard issue-tracker allows us to follow the 
> > > >>> progress of satisfying this requirement, or re-classifying it by 
> > > >>> changing the labels
> > > >>> (tags) if necessary.
> > > >>>
> > > >>> I just used the text from the UCR document directly, which 
> > > >>> includes the sub-heading number (6.1.1 in this case) which may 
> > > >>> be non-persistent if the UCR document is revised. On the other 
> > > >>> hand, the code [RDID] is also visible, which I think was intended to be a persistent identifier.
> > > >>>
> > > >>>
> > > >>> This issue is now found by a standard query for
> > > >>>
> > > >>> -          Issues tagged [dcat]
> > > >>>
> > > >>> o
> > > >>> https://github.com/w3c/dxwg/issues?utf8=%E2%9C%93&q=is%3Aopen+la
> > > >>> bel%3Adcat+
> > > >>>
> > > >>>
> > > >>> -          Issues tagged [dcat] and [requirement]
> > > >>>
> > > >>> o
> > > >>> https://github.com/w3c/dxwg/issues?utf8=%E2%9C%93&q=is%3Aopen+la
> > > >>> bel%3Arequirement+label%3Adcat+
> > > >>>
> > > >>>
> > > >>>
> > > >>>
> > > >>> I also see that Jaro has done a lot of clever Javascripting to 
> > > >>> get similar selection functions into the UCR document itself

> > > >>>
> > > >>> https://www.w3.org/TR/dcat-ucr/#Tags but I suggest that if we 
> > > >>> can use a generic tool (GitHub) which also does the dynamic 

> > > >>> record-keeping, then maybe we can reduce the need for bespoke scripting moving forward.
> > > >>>
> > > >>>
> > > >>> Simon
> > > >>>
> > > >>>
> > > >>>
> > > >>> *Simon J D Cox *
> > > >>>
> > > >>> Research Scientist
> > > >>>
> > > >>> Environmental Informatics
> > > >>>
> > > >>> CSIRO Land and Water <http://www.csiro.au/Research/LWF>
> > > >>>
> > > >>>
> > > >>>
> > > >>> *E* simon.cox@csiro.au *T* +61 3 9545 2365 <(03)%209545%202365> 
> > > >>> *M* +61
> > > >>> 403 302 672 <0403%20302%20672>
> > > >>>
> > > >>>     *Mail:* Private Bag 10, Clayton South, Vic 3169
> > > >>>
> > > >>> *   Visit: *Central Reception, Research Way, Clayton, Vic 3168
> 
> > > >>>
> > > >>> *   Deliver: *Gate 3, Normanby Road, Clayton, Vic
> > > >>> <https://maps.google.com/?q=3,+Normanby+Road,+Clayton,+Vic&entry
> > > >>> =gmail&source=g>
> > > >>> 3168
> > > >>>
> > > >>> people.csiro.au/Simon-Cox
> > > >>>
> > > >>> orcid.org/0000-0002-3884-3420
> > > >>>
> > > >>> researchgate.net/profile/Simon_Cox3
> > > >>> <https://www.researchgate.net/profile/Simon_Cox3>
> > > >>>
> > > >>> github.com/dr-shorthair
> > > >>>
> > > >>> lov.okfn.org/dataset/lov/agents/Simon%20Cox
> > > >>>
> > > >>> @dr_shorthair <https://twitter.com/dr_shorthair>
> > > >>>
> > > >>> https://xkcd.com/1810/
> > > >>>
> > > >>>
> > > >>>
> > > >>> *PLEASE NOTE*
> > > >>>
> > > >>> The information contained in this email may be confidential or privileged.
> > > >>> Any unauthorised use or disclosure is prohibited. If you have 
> > > >>> received this email in error, please delete it immediately and 
> > > >>> notify the sender by return email. Thank you. To the extent 

> > > >>> permitted by law, CSIRO does not represent, warrant and/or 
> > > >>> guarantee that the integrity of this
> 
> > > >>> communication has been maintained or that the communication is 
> > > >>> free of errors, virus, interception or interference.
> > > >>>
> > > >>>
> > > >>>
> > > >>> *Please consider the environment before printing this email.*
> > > >>>
> > > >>>
> > > >>>
> > > >>>
> > > >>>
> > > >   
> > > >   
> > > >   
> > > 
> >  
> >  
> >  
> > --
> > Jaroslav Pullmann
> > Fraunhofer Institute for Applied Information Technology FIT 
> > User-Centered Ubiquitous Computing Schloss Birlinghoven | D-53757 

> > Sankt Augustin | Germany
> > Phone: +49-2241-143620 | Fax: +49-2241-142146
> > 
> > 
> > 
>  
>  
>  
> --
> Jaroslav Pullmann
> Fraunhofer Institute for Applied Information Technology FIT User-Centered Ubiquitous Computing Schloss Birlinghoven | D-53757 Sankt Augustin | Germany
> Phone: +49-2241-143620 | Fax: +49-2241-142146 
> 
> 
 
 
 
-- 
Jaroslav Pullmann
Fraunhofer Institute for Applied Information Technology FIT
User-Centered Ubiquitous Computing
Schloss Birlinghoven | D-53757 Sankt Augustin | Germany
Phone: +49-2241-143620 | Fax: +49-2241-142146 
Received on Friday, 19 January 2018 10:25:23 UTC

This archive was generated by hypermail 2.3.1 : Monday, 29 April 2019 13:44:57 UTC