diff --git a/lib/config.template.php b/lib/config.template.php index b4f7249..7032e8b 100644 --- a/lib/config.template.php +++ b/lib/config.template.php @@ -1,8 +1,6 @@
<link rel="self" href="https://example.com/">
 <link rel="hub" href="https://switchboard.p3k.io/">

-

When you add a new item to the feed, send a POST request to https://switchboard.p3k.io/ with the following - parameters:

+

When you add a new item to the feed, send a POST request to https://switchboard.p3k.io/ with the following parameters:

-

Switchboard will send notifications to every subscriber that your feed has been updated. The request that Switchboard sends to your subscribers will be a POST request with no body. This is known as a "thin ping". Your subscribers will then request your feed to find updates.

- +

Switchboard will fetch your page to confirm that it has changed since it last sent notifications, and then will send notifications to every active subscriber. The request that Switchboard sends to your subscribers will be a POST request, and the body will be the full contents of your page. This is known as a "fat ping". Your subscribers can parse the body of the notification the same way they would parse your page, or they might request your page directly to find updates.

Subscribing

@@ -46,7 +44,7 @@

When there is new content available from the topic URL, Switchboard will send a POST request to your callback URL.

-

This POST request will have no body, and is meant to be an indication that the URL has been updated, and that you can fetch the new contents from there.

+

The POST request body will be the exact contents available at the topic URL. Switchboard fetches the HTML immediately so this value can be guaranteed to be "fresh" and not cached. You can parse this body the same way you would have parsed the contents of fetching the topic URL itself. The content type of the request will match the content type of the topic URL.