OWL Working Group Meeting Minutes, 28 January 2008
DRAFT. Currently Under Review
See also: IRC log
(Scribe changed to Peter Patel-Schneider)
Add discussion of Elisa's message to agenda.
Both outstanding action items completed.
Elisa's Action Item
Elisa Kendall: twice as many overviews as primers in W3C
Scribe Note: I believe that this is the result of searching for "overview" and "primer" in W3C web site.
Bijan Parsia: of what sort?
Elisa Kendall: not necessarily rec track
Elisa Kendall: overview - .....
Elisa Kendall: primer - longer document - some insight - not for experts
Elisa Kendall: quick start guide - pointers, a little bit of stuff - that's it
Elisa Kendall: short is needed
Bijan Parsia: guide goals are - short, entry point
Bijan Parsia: seems to align with Elisa's point
Bijan Parsia: longer guide is not necessary
Bijan Parsia: home page can serve as entry point
Bijan Parsia: inter doc pointers are very useful
Bijan Parsia: multiple documents are their own load
Bijan Parsia: home page can play role of entry point
Alan Ruttenberg: Guide = Primer - narrative story
Alan Ruttenberg: missing from Overview - small orientation document, delta from previous
Alan Ruttenberg: Can we merge reference, syntax, and semantics?
Alan Ruttenberg: merge reference and syntax - i.e., no separate 'reference'
Bijan Parsia: there is little information hiding needed - only reorganizaion
it would be nice to have Elisa's methodology on overview vs primer in the minutes
Elisa Kendall: overview = "fold out" document
Elisa Kendall: guide has to have a story
Elisa Kendall: issues with wine as an example ontology
Elisa Kendall: also guidance on how to do things
Peter Patel-Schneider: primer has a story
Elisa Kendall: guide also has an application - gives people a feeling of how to use an ontology
Bijan Parsia: not interested (right now) in detailed comments
Bijan Parsia: primer is first draft
Bijan Parsia: primer is supposed to cover overview and guide
Evan Wallace: I like primer - it is an introduction
Evan Wallace: fundamental tension between overview and guide - can there be one document
Evan Wallace: we may not need a long guide
Evan Wallace: ... what do we want to accomplish with UFD?
Evan Wallace: I would go for reference and introduction
Evan Wallace: also use cases - but this is not necessarily UF
Evan Wallace: Primer is better introduction than Overview + Guide
Alan Ruttenberg: to meet charter we need to show that our documents meet the goals
Bijan Parsia: what is needed - better replacements for old docs or meeting the deliverables
Conrad Bock: want intro & reference
Conrad Bock: also want guide
Conrad Bock: upgrading existing makes more sense
Conrad Bock: want to draw in software community into OWL - so emphasize differences
Conrad Bock: guide is longer (and reference is also)
Alan Ruttenberg: primer is a slightly longer document
Bijan Parsia: length per se is not the goal
Conrad Bock: different readers - "executives", ... - need different levels of explanation
Bijan Parsia: what about comprehensiveness
Deborah McGuinness: users search in guide for constructors
Bijan Parsia: users use guide as reference?
Bijan Parsia: if reference was better organized then it might serve the same purpose
Deborah McGuinness: users use guide as [cookbook] when they can't hack the references
Deborah McGuinness: that's why I agree that there is a tension between overview and guide
Deborah McGuinness: I thought that primer would be comprehensive for constructors
Alan Ruttenberg: comprehensiveness in tension with narrative?
Ian Horrocks: only 10 minutes left ...................................................................
Ian Horrocks: did Deborah say that Primer could replace Guide
Deborah McGuinness: if it was constructor comprehensive
Ian Horrocks: is there an agreement that Primer could replace Guide?
Deborah McGuinness: yes - but also think about wine agent
Conrad Bock: i didn't use guide
Bijan Parsia: does guide have to be a reference as well?
Bijan Parsia: let's not end up with more documents (in rec track)
Peter Patel-Schneider: primer is already almost constructor comprehensive
Alan Ruttenberg: Primer can overtake guide if constructor comprehensive
PROPOSED: primer could become a replacement for the guide modulo a few concerns
Alan Ruttenberg: hang on please