documentation icon indicating copy to clipboard operation
documentation copied to clipboard

https://docs.joinmastodon.org/user/quote-posts/ is inconsistent about "quote post", and ends up being contradictory

Open nikclayton opened this issue 1 month ago • 0 comments

https://docs.joinmastodon.org/user/quote-posts/ starts describing "quote posts".

From the context, and how the web UI works, I think most of the time when it talks about a "quote post" it means "The post you get when you press the boost/quote button in the web UI".

This leads to the FAQ section saying:

Do quote posts appear in the same context as a thread, or do they create a new context?

Quote posts create a new context, and do not appear in the replies. Replies to the quote post will only notify you if you are also mentioned.

  • https://docs.joinmastodon.org/user/quote-posts/#faq-context

This suggests quote posts are always top-level posts; they start their own thread.

In a different section it then says:

Can I quote and reply at the same time?

Yes. Start writing a reply, then click the “Quote” button on the post you want to quote. The quote will be attached to the reply.

  • https://docs.joinmastodon.org/user/quote-posts/#faq-with-reply

The "reply" created here is also a "quote post", and it does not create a new thread.

The document would probably be clearer if this information was presented as:

  1. A general discussion of a post that contains a quote, and the controls the quotee has
  2. How to quote a post and create a new thread
  3. How to reply to an existing post and include a quote

Then both those FAQ questions can be removed.

nikclayton avatar Nov 15 '25 16:11 nikclayton