W3C home > Mailing lists > Public > public-bioschemas@w3.org > November 2017

Re: thoughts on map2model

From: Leyla Garcia <ljgarcia@ebi.ac.uk>
Date: Thu, 30 Nov 2017 16:05:17 +0000
To: "McLeod, Kenneth" <Kenneth.McLeod@hw.ac.uk>, Niall Beard <niall.beard@manchester.ac.uk>
Cc: "public-bioschemas@w3.org" <public-bioschemas@w3.org>, "Gray, Alasdair J G" <A.J.G.Gray@hw.ac.uk>
Message-ID: <a1a97481-0a20-e27d-c1b2-bd0fb0e9d724@ebi.ac.uk>
Hi Keneth,

What you propose, having you and Alasdair running map2model, makes sense 
to me.

I agree with your comments. Using a spreadsheet in Google Drive makes 
things easy for contributors. And yes, the steps involved in map2model 
are not that difficult but not as simple as it ideally should be. But we 
are short or resources and time, so by now leaving the burden to run 
map2model to editors sounds like the way to go.

If anything, I would suggest to make the spreadsheet template simpler. 
Some of the initial columns with use cases are not used anymore and for 
a new comer they might be confusing. And, maybe some notes about what to 
put there? I do not remember if we have them already. For instance, 
things like you do not need to add the description or expected type for 
things coming from schema.org because in any case the map2model will 
overwrite them.

I am happy to help as an editor too as I already install map2model. I 
can always use pull requests and assign them to you or Alasdair.


On 28/11/2017 11:38, McLeod, Kenneth wrote:
> Dear Leyla, Niall
> As you have both used map2model, Alasdair and I wondered if you had 
> any suggestions for how to improve the tooling/workflow?
> From our perspective we like the fact that contributors are able to 
> write their specifications in gDocs. We feel using map2model to 
> generate the markdown/html files, which involves logging into google 
> via the browser then manually copying the generated files to the 
> bioschemas.github.io repo, is not ideal. In a perfect world, we would 
> turn this into a fully automatic service where the editor was able to 
> 'push a button', and the newly generated spec would appear on the 
> bioschemas site. However, I am not a python dev and have no experience 
> with the google platform, so I am not sure how complex/expensive this 
> would be. With the limited resources available we need a simple/quick 
> solution and suspect that the automatic service is too time consuming.
> Guillermo planned to have the editors use map2model directly, but this 
> seems unlikely due to the complexity of installing git, python3, 
> map2model ...
> Our third option was that a small group of people (initially Alasdair 
> and myself) run map2model on behalf of the editors. When the editors 
> wish to publish a new draft, they send a message (perhaps a Git 
> issue?) and a member of the group runs map2model and updates the 
> bioschema's site. Despite the obvious flaws, this is the quickest 
> solution to implement and thus our current favourite.
> Is there a fourth option? Any other thoughts?
> Thanks for your input,
> Ken
> --
> Kenneth McLeod, PhD
> Biomedical Systems Engineering Lab: http://www.bisel.uk
> School of Mathematical and Computer Sciences
> Heriot-Watt University
> 1507020418880_image001.png
> Untitled Document
> ------------------------------------------------------------------------
> */Heriot-Watt University is The Times & The Sunday Times International 
> University of the Year 2018/*
> Founded in 1821, Heriot-Watt is a leader in ideas and solutions. With 
> campuses and students across the entire globe we span the world, 
> delivering innovation and educational excellence in business, 
> engineering, design and the physical, social and life sciences.
> This email is generated from the Heriot-Watt University Group, which 
> includes:
>  1. Heriot-Watt University, a Scottish charity registered under number
>     SC000278
>  2. Edinburgh Business School a Charity Registered in Scotland,
>     SC026900. Edinburgh Business School is a company limited by
>     guarantee, registered in Scotland with registered number SC173556
>     and registered office at Heriot-Watt University Finance Office,
>     Riccarton, Currie, Midlothian, EH14 4AS
>  3. Heriot- Watt Services Limited (Oriam), Scotland's national
>     performance centre for sport. Heriot-Watt Services Limited is a
>     private limited company registered is Scotland with registered
>     number SC271030 and registered office at Research & Enterprise
>     Services Heriot-Watt University, Riccarton, Edinburgh, EH14 4AS.
> The contents (including any attachments) are confidential. If you are 
> not the intended recipient of this e-mail, any disclosure, copying, 
> distribution or use of its contents is strictly prohibited, and you 
> should please notify the sender immediately and then delete it 
> (including any attachments) from your system.
Received on Thursday, 30 November 2017 16:05:46 UTC

This archive was generated by hypermail 2.4.0 : Friday, 17 January 2020 19:08:00 UTC