# 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 10
# self = https://watcher.sour.is/conv/jgxf3yq
@prologic: Reduced refresh interval to 7200 seconds :-)
@win0err Maybe you can help us with that part of the spec? 🤔 It was added to honestly squelch really only one grumpy Twtxt user at the time, so we did it 😅 But really a well behaving client will periodically fetch a feed but respect HTTP headers like Last-Modified and so the hit on a web server is minimal at best. -- And as you just found, _many_ clients don't yet actually even respect this field, only really yarnd does (I believe). -- And if you set it too big well then maybe nobody sees your post for a while 😅

I would offer documentation on our use of the WebSub protocol, however this is not possible to implement for feed authors in _all_ cases, especially on multi-user hostrs like many of the tilde(s) I think... -- Is this something we _should_ document as an optional client feature? (I feel most feed authors probably wouldn't care all that much)
@win0err Maybe you can help us with that part of the spec? 🤔 It was added to honestly squelch really only one grumpy Twtxt user at the time, so we did it 😅 But really a well behaving client will periodically fetch a feed but respect HTTP headers like Last-Modified and so the hit on a web server is minimal at best. -- And as you just found, _many_ clients don't yet actually even respect this field, only really yarnd does (I believe). -- And if you set it too big well then maybe nobody sees your post for a while 😅

I would offer documentation on our use of the WebSub protocol, however this is not possible to implement for feed authors in _all_ cases, especially on multi-user hostrs like many of the tilde(s) I think... -- Is this something we _should_ document as an optional client feature? (I feel most feed authors probably wouldn't care all that much)
@win0err Maybe you can help us with that part of the spec? 🤔 It was added to honestly squelch really only one grumpy Twtxt user at the time, so we did it 😅 But really a well behaving client will periodically fetch a feed but respect HTTP headers like Last-Modified and so the hit on a web server is minimal at best. -- And as you just found, _many_ clients don't yet actually even respect this field, only really yarnd does (I believe). -- And if you set it too big well then maybe nobody sees your post for a while 😅

I would offer documentation on our use of the WebSub protocol, however this is not possible to implement for feed authors in _all_ cases, especially on multi-user hostrs like many of the tilde(s) I think... -- Is this something we _should_ document as an optional client feature? (I feel most feed authors probably wouldn't care all that much)
@win0err Maybe you can help us with that part of the spec? 🤔 It was added to honestly squelch really only one grumpy Twtxt user at the time, so we did it 😅 But really a well behaving client will periodically fetch a feed but respect HTTP headers like Last-Modified and so the hit on a web server is minimal at best. -- And as you just found, _many_ clients don't yet actually even respect this field, only really yarnd does (I believe). -- And if you set it too big well then maybe nobody sees your post for a while 😅

I would offer documentation on our use of the WebSub protocol, however this is not possible to implement for feed authors in _all_ cases, especially on multi-user hostrs like many of the tilde(s) I think... -- Is this something we _should_ document as an optional client feature? (I feel most feed authors probably wouldn't care all that much)
@prologic I guess that refresh field could be easily replaced with Expires HTTP header (I realize that users on neocities.org cannot control this header, for example). And clients should also respect headers like Last-Modified/If-Modified-Since (304), you're right about that. P.S. twtwt doens't have a caching mechanism for now, but I plan to implement it in generic way using HTTP headers.
@win0err If you're referring to the original twtxt, then yes, it left a lot of things out and quite a bit of it is ambitious 😢 -- It _might_ be worthwhile one day either:

1. rewriting the spec (which @mckinley has done a nice job of, but I still want to host that at https://dev.twtxt.net in Markdown 😅)
2. start writing "client recommendations" (like what we did with extensions)
@win0err If you're referring to the original twtxt, then yes, it left a lot of things out and quite a bit of it is ambitious 😢 -- It _might_ be worthwhile one day either:

1. rewriting the spec (which @mckinley has done a nice job of, but I still want to host that at https://dev.twtxt.net in Markdown 😅)
2. start writing "client recommendations" (like what we did with extensions)
@win0err If you're referring to the original twtxt, then yes, it left a lot of things out and quite a bit of it is ambitious 😢 -- It _might_ be worthwhile one day either:

1. rewriting the spec (which @mckinley has done a nice job of, but I still want to host that at https://dev.twtxt.net in Markdown 😅)
2. start writing "client recommendations" (like what we did with extensions)
@win0err If you're referring to the original twtxt, then yes, it left a lot of things out and quite a bit of it is ambitious 😢 -- It _might_ be worthwhile one day either:

1. rewriting the spec (which @mckinley has done a nice job of, but I still want to host that at https://dev.twtxt.net in Markdown 😅)
2. start writing "client recommendations" (like what we did with extensions)