New project for documenting miscellaneous terms

Hello! In our meeting on Friday, the CG decided to create a report 
documenting widely-used terms added to the Activity Streams 2.0 
namespace using the "@vocab" feature so far in the history of the protocol.

(If you just drop a property into an AS2 document, because the AS2 
context document includes '@vocab: "_:"', those properties are in the 
AS2 namespace. That's not the recommended way to do extensions any more, 
but it was popular in the early days of AP.)

The goal of this report is to document popular terms inserted into the 
AS2 namespace, and include them in a separate context document. Then, we 
can use the Extensions Policy to add the terms into the AS2 context.

The secondary goal is to test the SocialCG's extension policy, currently 
in draft status:

https://swicg.github.io/extensions-policy/

This project would push the bounds of that extension policy in at least 
one way; it doesn't use a well-defined namespace -- by definition! But 
otherwise it should be a good test of the policy.

If you have ideas for existing undocumented AS2 terms seen in the wild 
that should be included, please make a note here:

https://github.com/swicg/miscellany/issues

The current context doc is here:

https://purl.archive.org/socialweb/miscellany

And the document will be here when it's written (currently boilerplate 
ReSpec):

https://swicg.github.io/miscellany/

Lastly, I had one person step forward to help out with this; if you 
think you'd be a good co-editor on this document, let me know.

Evan

Received on Sunday, 7 April 2024 23:36:54 UTC