I note that early in your document you mention that some of these features will "not necessarily translate directly to User Experience considerations".
You'll note that some of my questions below are driven by user experience considerations. It's my experience that failing to consider the desired end user experience early enough in the process can result in specs that are not suitable.
---
In the "Representation of a quote post" section the content
looks like this:
"content": "I am quoting alice's postRE: https://example.com/users/alice/statuses/1",
What's the RE: ...
text doing there? If the user entered it, doesn't this undermine the point of quoting the post?
Or are you suggesting the server has appended this to end of the content the user entered?
---
What is the default quote policy (acceptQuotesFrom
) if it is not provided?
Since this may depend on the post's visibility settings and mentions a "default quote policy" may not be possible, and the correct question might be "What is the algorithem for determining the acceptQuotesFrom
value if the property is not present?".
---
acceptsQuotesFrom
appears to be a single property. Shouldn't it be a list, to allow the author to choose a small number of people who may quote them?
---
People mentioned in the post can always quote it.
- User A sends post 1 mentioning user B.
- User B quotes the post in post 2.
- User A edits post 1 and removes the mention of user B, and sets
acceptsQuotesFrom
to disallow quoting.
What happens to post 2 by user B at step 2? At the time it was posted they were authorised to quote it, and there exists, in the edit history, a version of post 1 that does mention them.
---
How many posts can be listed as "quote posts" on a given top-level post?
---
In the user agent, are quoted posts expected to be treated like attachments (which do not count against the character limit), or URLs, or something else?
---
If an account is deleted, what happens to posts that quote posts from that account? Is the permission-to-quote revoked?
---
Consider a post B that quotes another post A.
The user that posted A revokes the quote permission.
Is the quote Link
entirely removed from post B, as if it was never there? Or is some sort of tombstone Link
written, so that user agents can provide the context that there used to be something there?
This context ("this post quoted a post that is no longer quotable") might be necessary to make post B make sense.
---
Sending a post-with-a-quote and getting approval for the quote can be asynchronous. So someone's timeline of posts may contain a post with an unapproved quote. What is the intended user experience here?
- Show the post, with the quote
- Hide the post
- Show the post, with the quote, but indicate the quote is unapproved?
---
Where are user agents supposed to render the quote? Above the text of the post, or below?
Alternatively, why not provide a mechanism in the Note
object for the post author to indicate where they would like (on a per-quote basis) the quote to be rendered.
---
Can I create cycles in the quote graph? For example:
- I create Note A. I then update A to quote itself.
- I create Note A and B. B quotes A. Then I update A to quote B.
- Notes A, B, and C are created. B quotes A, C quotes B. Then A is edited to quote C.
---
Authors of posts are notified if their post is quoted.
What provision is there to notify authors of the post doing the quoting, if the post they are quoting is modified?
---
Do quotes of quotes generate notifications?
- User A sends post 1
- User B sends post 2, quoting post 1
- User C sends post 3, quoting post 2
Does user A get a notification about post 3 because it indirectly quotes their post 1?
---
What properties, if any, should be inherited by the post doing the quoting? For example, if I quote a post marked "sensitive", is my post also marked sensitive?
If not, what is the intended user-agent behaviour for displaying a non-sensitive post quoting a sensitive post?
---
Same question, but for content warnings (summary
).
---
I write post A. It is quoted in post B.
Post B is then boosted, favourited, or some other reaction is performed. As the author of post A, does that generate a notification to me?
---
I may want to quote a very long post, but only refer to part of it (maybe a sentence or two). There is no mechanism here that would allow me to do that. Think of it like setting the focus on an image attachment; you still get the whole attachment, but I control what shows up in the preview.
---
User A sends post 1, marks it as followers-only (for both visibility and quoting).
User B follows user A, and sends post 2, quoting post 1. They mark post 2 as public.
User C follows user B, but does not follow user A, so they cannot see post 1 from user A.
Post 2 appears in user C's timeline. What do they see?
Alternatively, at step 2, is user B allowed to send a public post that quotes a post with a narrower quoting visibility? Are they prevented from sending the post entirely? Or is the visibility of their post 2 restricted to just the followers of user A? If so, how is restriction communicated to user B?