# I am the Watcher. I am your guide through this vast new twtiverse.
#
# Usage:
# https://watcher.sour.is/api/plain/users View list of users and latest twt date.
# https://watcher.sour.is/api/plain/twt View all twts.
# https://watcher.sour.is/api/plain/mentions?uri=:uri View all mentions for uri.
# https://watcher.sour.is/api/plain/conv/:hash View all twts for a conversation subject.
#
# Options:
# uri Filter to show a specific users twts.
# offset Start index for quey.
# limit Count of items to return (going back in time).
#
# twt range = 1 4
# self = https://watcher.sour.is/conv/tavz4dq
FYI: I'm going to introduce a new Metadata field spec, probably under a new section like "Optional Fields". A field called type that helps to "categorise" feeds as one of a few (small number) of "Feed Types". For example:
# type = <type>
Where currently <type> is one of:
- bot -- An automated feed or a bot
- rss -- An Atom/RSS feed such as those from feeds.twtxt.net
Thoughts? 🤔 This helps me do a couple of things:
- Remove the "hard-coded" feeds.twtxt.net from the yarnd codebase as a way to filter them out of the "Discover" view.
- Index feeds appropriately so you can search for different types of feeds (e.g: excluding automated or rss feeds, just real users)
FYI: I'm going to introduce a new Metadata field spec, probably under a new section like "Optional Fields". A field called type that helps to "categorise" feeds as one of a few (small number) of "Feed Types". For example:
# type = <type>
Where currently <type> is one of:
- bot -- An automated feed or a bot
- rss -- An Atom/RSS feed such as those from feeds.twtxt.net
Thoughts? 🤔 This helps me do a couple of things:
- Remove the "hard-coded" feeds.twtxt.net from the yarnd codebase as a way to filter them out of the "Discover" view.
- Index feeds appropriately so you can search for different types of feeds (e.g: excluding automated or rss feeds, just real users)
If there are no obvious objections, I will write this up soonâ„¢ -- One thing to note however is there are only two types at the moment and I intend to add a set of enums to the go.yarn.social/types Go package -- rss and bot.
This means users generally don't have to _actually_ do anything at all, only if they author an automated feed (by some other means) or construct other automated feeds whose real source is RSS/Atom (by other other means).
If there are no obvious objections, I will write this up soonâ„¢ -- One thing to note however is there are only two types at the moment and I intend to add a set of enums to the go.yarn.social/types Go package -- rss and bot.
This means users generally don't have to _actually_ do anything at all, only if they author an automated feed (by some other means) or construct other automated feeds whose real source is RSS/Atom (by other other means).