W3C home > Mailing lists > Public > public-sdw-wg@w3.org > June 2015

the Best Practices skeleton

From: Frans Knibbe <frans.knibbe@geodan.nl>
Date: Thu, 25 Jun 2015 11:12:01 +0200
Message-ID: <CAFVDz4383a5-K5FZhJF7SxfEgPS5Sa0ZziLkZVvRHEk1U4gpCw@mail.gmail.com>
To: SDW WG Public List <public-sdw-wg@w3.org>
Dear group.

We did not get to discuss the Best Practices skeleton at the meeting
yesterday but I did think about the item a bit so I would like to share my
thoughts before they fade away.

The suggested skeleton
<https://www.w3.org/2015/spatial/wiki/Notes_for_Context#Suggested_Skeleton>
looks like the document is going to be a collection of recommendations,
with chapters grouping together strongly related recommendations. I think
it could be nice to present recommendations in the form of recipes or
stories. Not instead of the suggested structure, but perhaps next to that.

Two basic stories that can be told are:

   1. How to publish spatial data on the web
   2. How to consume spatial data on the web

Such stories could provide step by step instructions on what to do,
illustrated by examples. If such general stories will have too many
variations, some more focused stories could be told, for instance:

   1. Alice has a data set containing spatial data. She thinks it might be
   useful to someone, so she wants to publish it on the web. Which steps does
   she need to take?
   2. Bob is developing a smart phone application that provides a user with
   information based on current location. How can he tap in to the web of
   spatial data and put the data to use in his application?
   3. Carol is doing research on global climate change. How can she find
   and query the data that might be applicable to her research?

Of course the collected use cases could serve as a source of inspiration
for specific stories.

I believe stories are easy to read and easy to understand. And I think that
step by step instructions with examples are what many people would
appreciate.

Next to stories we could have a comprehensive set of recommendations on
various subjects. That would allow people to look up information about a
specific subject. Such reference information could be structured according
to the suggested skeleton. From the stories references could be made to
those recommendations, allowing someone reading a story to drill down to
background information, if required.

Regards,
Frans









-- 
Frans Knibbe
Geodan
President Kennedylaan 1
1079 MB Amsterdam (NL)

T +31 (0)20 - 5711 347
E frans.knibbe@geodan.nl
www.geodan.nl
disclaimer <http://www.geodan.nl/disclaimer>
Received on Thursday, 25 June 2015 09:12:37 UTC

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