W3C home > Mailing lists > Public > public-sdw-wg@w3.org > May 2016

LODES of cleaning up

From: Phil Archer <phila@w3.org>
Date: Tue, 24 May 2016 15:06:05 +0100
To: Kerry Taylor <kerry.taylor@anu.edu.au>, "janowicz@ucsb.edu" <janowicz@ucsb.edu>, "Le Phuoc, Danh" <danh.lephuoc@deri.org>, Armin Haller <armin.haller@anu.edu.au>
Cc: SDW WG Public List <public-sdw-wg@w3.org>
Message-ID: <46906857-3805-18a4-d298-14e4726c0833@w3.org>
SSN Editors,

I've been through the markup generated by LODE. Nothing wrong with it as 
such but there's an awful lot of code that doesn't do a great deal once 
you get to a doc like this. So a typical definition section now looks 
like this:

<section id="h-MaintenanceSchedule" class="entity">
   <h4 id="MaintenanceSchedule">Maintenance Schedule</h4>
   <p class="iri"> http://www.w3.org/ns/ssn/MaintenanceSchedule</p>
   <p class="comment">Schedule of...</p>
   <dl class="description">
    <dt>has super-classes</dt>
    <dd><a href="#OperatingProperty" 
title="http://www.w3.org/ns/ssn/OperatingProperty">OperatingProperty</a></dd>
   </dl>
</section>

I've got rid of all the generated IDs (d3015 or whatever) and replaced 
them with the actual terms as IDs on the <h4 /> elements - which means 
that the frag IDs within the doc are now the actual terms. A bit of CSS 
takes care of the IRIs, decoration of the super/sub classes etc.

One thing I got rid of that you might like is LODE's addition of 
superscripts for 'c' and 'op' for Class, Object property etc. Hope 
that's not a problem.

I've run the doc through the validators etc. so it should be all OK now. 
Two things I haven't done are:

1. Check that the doc uses simplified English throughout (some people 
call it American English). The poor colonials really can't cope with 
etymologically accurate orthography, bless 'em.

2. Check for a bit of W3C-weirdness. For our own historical reasons, we 
always capitalise Web (I know, I know but it's house rules and all that).

Obviously I have not applied any relevant OGC rules.

You can see the result of my labour at 
http://philarcher1.github.io/sdw/ssn/ and, if you so wish, accept my 
Pull Request https://github.com/w3c/sdw/pull/262

HTH

Phil.


-- 


Phil Archer
W3C Data Activity Lead
http://www.w3.org/2013/data/

http://philarcher.org
+44 (0)7887 767755
@philarcher1
Received on Tuesday, 24 May 2016 14:06:31 UTC

This archive was generated by hypermail 2.4.0 : Thursday, 24 March 2022 20:31:21 UTC