- 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>
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