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: Thu, 18 Jan 2018 23:02:35 +0100
To: "Alejandra Gonzalez-Beltran" <alejandra.gonzalezbeltran@oerc.ox.ac.uk>
Message-ID: <4a01-5a611980-79-1d1c55c0@145683299>
Cc: Simon.Cox@csiro.au, "Rob Atkinson" <rob@metalinkage.com.au>, public-dxwg-wg@w3.org

  Hello Alejandra,

> At the moment, there is some duplication in the labels, so we can revise 
> them when we go through the requirements. Anyway, we discussed in the 
> DCAT call that we need to revise the labels from the UCR document, as 
> these are inherited from the use cases at the moment.

   yes, the labels need to be sorted out and assigned manually. In the next
  UCR version the requirements will retain the curated tags and cross-references. 

> I think it would be worth keeping the scripts in the same repository - 
> what do you think?

   thats's fine, should I create a folder beneath /dxwg (e.g. utils)?

  Cheers 
   Jaro


> 
> Best,
> 
> Alejandra
> 
> 
> On 18/01/2018 21:26, Jaroslav Pullmann wrote:
> >    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+label%3Adcat+
> >>>>>>
> >>>>>>
> >>>>>> -          Issues tagged [dcat] and [requirement]
> >>>>>>
> >>>>>> o
> >>>>>> https://github.com/w3c/dxwg/issues?utf8=%E2%9C%93&q=is%3Aopen+label%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 
Received on Thursday, 18 January 2018 22:03:29 UTC

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