wiki.trwnh.com/content/tech/spec/activitypub/shortcomings/unclear-type-semantics.md

28 lines
1.2 KiB
Markdown
Raw Normal View History

2023-04-28 19:07:59 +00:00
+++
+++
# the semantics of some types are unclear or poorly defined
## Note vs Article
see [Note vs Article]({{<relref "note-vs-article.md" >}}) for more. but basically:
in summary:
> Note: Represents a short written work typically less than a single paragraph in length.
> Article: represents any kind of multi-paragraph written work.
but this is contradicted by as2/ap examples.
the messy general consensus post-spec seems to be about "intention", but this is never defined. it is unclear what a `Note` is intended to be, and what an `Article` is intended to be, beyond very loosely and very vaguely tying such notions to app-specific abstractions or behavior. for example, Mastodon will show a Note more or less in full, but convert an Article to a title and url.
it would have been better to define it similarly to HTML `<article>` perhaps? an independent unit of writing? one that is published and therefore might reasonably be syndicated?
## Mention
> Mention: A specialized Link that represents an @mention.
this is an incredibly narrow definition and also one that is often useless. what's so special about an @mention?
it would have been better to define it in terms of, idk, generating a notification or something? like a webmention?