ISSUE-16: better separate grammar/vocabulary and improved spec structure

grammar/vocabulary

better separate grammar/vocabulary and improved spec structure

State:
CLOSED
Product:
Activity Streams 2.0
Raised by:
Erik Wilde
Opened on:
2015-03-02
Description:
hello.

i have a proposal for improving the AS 2.0 spec structure in the sense that the spec structure better aligns with developer expectations, will become easier to read and implement, and maybe also provides a cleaner path to define and support an extension model.

- what's currently called "core" classes/types (http://www.w3.org/TR/activitystreams-vocabulary/#types) should become part of the basic AS model that is defined by the current AS core WD. after all, this is the "grammar" of AS, it's what establishes the basic resources of AS, and the ways in which these are establishing the AS resource model, and how it is serialized.

- what's currently called "extended" classes/types (http://www.w3.org/TR/activitystreams-vocabulary/#extendedtypes) should become the only content of the "vocabulary" spec and should be called "core vocabulary", because that's the common/shared vocabulary of AS that's supposed to be shared across (all or at least the vast majority of) implementations.

here are the reasons for this proposal:

- we should clearly separate they fundamental model (resources and their grammar) of AS, and vocabularies using this model. currently, the former is split across two specs, and the latter is not self-contained in its own spec.

- the AS 2.0 core vocabulary (according to the proposed new terminology) should provide a good and direct blueprint for people creating their own vocabularies. they should be able to take the vocabulary spec and use it as a template very directly.

this should give us a better path towards a clean and well-defined extension model, which in essence should tell:

- developers how to define additional vocabularies, and most importantly, what kinds of things they can define in those vocabularies, and

- users one way how to learn about additional vocabularies, should the developers choose to document them in the way proposed by us.

our goal is to have a clean extension model, and to have a well-defined and well-documented way in which vocabulary developers can use that extension model. we are working on a model that is definitely inspired by james' work on AS 1.0 "Verb Definitions for Activity Streams" https://raw.githubusercontent.com/activitystreams/activity-streams-verb-definition/master/activity-streams-verb-definition.txt, with the eventual goal of having some kind of "AS Schema Language" that allows the sharing of information *about* AS.

if there are others having the same interests (going beyond the built-in schema), it would be great to hear about their plans and ideas for how to best set up the current spec structure to better separate grammar and vocabulary, and eventually how to actually define those vocabulary extensions.

thanks and cheers,

dret.
Related Actions Items:
No related actions
Related emails:
  1. Re: extension model of RSS/Atom (ISSUE-16 discussion) (from dret@berkeley.edu on 2015-04-13)
  2. Re: extension model of RSS/Atom (ISSUE-16 discussion) (from perpetual-tripper@wwelves.org on 2015-04-13)
  3. Re: extension model of RSS/Atom (ISSUE-16 discussion) (from dret@berkeley.edu on 2015-04-12)
  4. Re: extension model of RSS/Atom (ISSUE-16 discussion) (from perpetual-tripper@wwelves.org on 2015-04-12)
  5. Re: extension model of RSS/Atom (ISSUE-16 discussion) (from dret@berkeley.edu on 2015-04-12)
  6. Re: extension model of RSS/Atom (ISSUE-16 discussion) (from perpetual-tripper@wwelves.org on 2015-04-12)
  7. Re: extension model of RSS/Atom (ISSUE-16 discussion) (from dret@berkeley.edu on 2015-04-07)
  8. Re: extension model of RSS/Atom (ISSUE-16 discussion) (from jasnell@gmail.com on 2015-04-07)
  9. extension model of RSS/Atom (ISSUE-16 discussion) (from dret@berkeley.edu on 2015-04-07)
  10. Re: Regular weekly meeting 7 Apr 2015 (from cwebber@dustycloud.org on 2015-04-07)
  11. Re: Regular weekly meeting 7 Apr 2015 (from perpetual-tripper@wwelves.org on 2015-04-07)
  12. Re: Regular weekly meeting 7 Apr 2015 (from lehors@us.ibm.com on 2015-04-07)
  13. Re: Regular weekly meeting 7 Apr 2015 (from evan@e14n.com on 2015-04-07)
  14. Re: Regular weekly meeting 7 Apr 2015 (from perpetual-tripper@wwelves.org on 2015-04-07)
  15. Re: AS 2.0 Test Suite Approach (from dret@berkeley.edu on 2015-04-01)
  16. Re: AS2 Issues List (from jasnell@gmail.com on 2015-03-31)
  17. Re: AS2 Issues List (from perpetual-tripper@wwelves.org on 2015-03-31)
  18. AS2 Issues List (from jasnell@gmail.com on 2015-03-31)
  19. Re: social-ISSUE-16 (grammar/vocabulary): better separate grammar/vocabulary and improved spec structure [Activity Streams 2.0] (from dret@berkeley.edu on 2015-03-29)
  20. Re: social-ISSUE-16 (grammar/vocabulary): better separate grammar/vocabulary and improved spec structure [Activity Streams 2.0] (from perpetual-tripper@wwelves.org on 2015-03-29)
  21. Re: social-ISSUE-16 (grammar/vocabulary): better separate grammar/vocabulary and improved spec structure [Activity Streams 2.0] (from dret@berkeley.edu on 2015-03-29)
  22. Re: social-ISSUE-16 (grammar/vocabulary): better separate grammar/vocabulary and improved spec structure [Activity Streams 2.0] (from perpetual-tripper@wwelves.org on 2015-03-29)
  23. Re: Removing Activity Types not used by User Stories (from perpetual-tripper@wwelves.org on 2015-03-27)
  24. Re: Removing Activity Types not used by User Stories (from jasnell@gmail.com on 2015-03-26)
  25. Re: Removing Activity Types not used by User Stories (from henry.story@bblfish.net on 2015-03-26)
  26. Re: Removing Activity Types not used by User Stories (from perpetual-tripper@wwelves.org on 2015-03-25)
  27. Re: Removing Activity Types not used by User Stories (from dret@berkeley.edu on 2015-03-25)
  28. Re: Removing Activity Types not used by User Stories (from perpetual-tripper@wwelves.org on 2015-03-25)
  29. Re: social-ISSUE-16 (grammar/vocabulary): better separate grammar/vocabulary and improved spec structure [Activity Streams 2.0] (from dret@berkeley.edu on 2015-03-10)
  30. Re: social-ISSUE-16 (grammar/vocabulary): better separate grammar/vocabulary and improved spec structure [Activity Streams 2.0] (from perpetual-tripper@wwelves.org on 2015-03-09)
  31. social-ISSUE-16 (grammar/vocabulary): better separate grammar/vocabulary and improved spec structure [Activity Streams 2.0] (from sysbot+tracker@w3.org on 2015-03-02)

Related notes:

Erik currently works on (AS1 based) Activity Stream Documentation Language (ASDL)
https://github.com/dret/ASDL

Pavlik elf, 17 Mar 2015, 11:02:21

jasnell is happy to accept pull requests regarding this, or specific feedback.

Tantek Çelik, 26 May 2015, 17:22:11

Display change log ATOM feed


Tantek Çelik <tantek@cs.stanford.edu>, Evan Prodromou <evan@e14n.com>, Chairs, Sandro Hawke <sandro@w3.org>, Amy Guy <rhiaro@w3.org>, Staff Contacts
Tracker: documentation, (configuration for this group), originally developed by Dean Jackson, is developed and maintained by the Systems Team <w3t-sys@w3.org>.
$Id: index.php,v 1.325 2014-09-10 21:42:02 ted Exp $