From 2f21b2a1969e84ce22faf7f80ae884369eb73c3b Mon Sep 17 00:00:00 2001 From: CJ Eller <45696734+cjeller1592@users.noreply.github.com> Date: Tue, 7 Jan 2020 13:33:53 -0500 Subject: [PATCH 1/3] Create federation.md --- writer/federation.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) create mode 100644 writer/federation.md diff --git a/writer/federation.md b/writer/federation.md new file mode 100644 index 0000000..963659b --- /dev/null +++ b/writer/federation.md @@ -0,0 +1,19 @@ +# Federation + +WriteFreely supports federation via ActivityPub, a protocol spoken by popular platforms like [Mastodon](https://joinmastodon.org) (an alternative to Twitter). This means that when you enable federation for your WriteFreely blogs, they'll get their own handle that people can follow from the fediverse. + +## Finding your handle + +To find your handle, go into your blog's settings. Under _URL_ will be your blog's fediverse handle, following the format blog@instance. + +## Following your blog + +To follow your blog, open Mastodon and search for the fediverse handle in your settings page. Click follow and you'll start seeing future posts in your timeline, where you can favorite or boost them to your followers. + +## Note about changing your username + +If you change your username, a new fediverse handle will be created. The previous fediverse handle will stop being updated. Anyone who was following your previous fediverse handle will not automatically be following the new one. This means they will have to follow the new handle in order to receive your most recent posts. + +## Demo + +[Watch this video](https://video.writeas.org/videos/watch/cc55e615-d204-417c-9575-7b57674cc6f3) to see this feature in action. From 31ec1f602e17c3951a7472ac462e38fa67676929 Mon Sep 17 00:00:00 2001 From: Matt Baer Date: Mon, 13 Jan 2020 09:59:03 -0500 Subject: [PATCH 2/3] Tweak verbiage on Federation guide a bit --- writer/federation.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/writer/federation.md b/writer/federation.md index 963659b..a651d98 100644 --- a/writer/federation.md +++ b/writer/federation.md @@ -1,6 +1,6 @@ # Federation -WriteFreely supports federation via ActivityPub, a protocol spoken by popular platforms like [Mastodon](https://joinmastodon.org) (an alternative to Twitter). This means that when you enable federation for your WriteFreely blogs, they'll get their own handle that people can follow from the fediverse. +WriteFreely supports federation via ActivityPub, a protocol spoken by popular platforms like [Mastodon](https://joinmastodon.org) (an alternative to Twitter). This means that other people can directly follow your blog from the decentralized social network known as the "fediverse," if your WriteFreely admin has enabled federation. ## Finding your handle @@ -8,11 +8,11 @@ To find your handle, go into your blog's settings. Under _URL_ will be your blog ## Following your blog -To follow your blog, open Mastodon and search for the fediverse handle in your settings page. Click follow and you'll start seeing future posts in your timeline, where you can favorite or boost them to your followers. +To follow your blog, open Mastodon, Pleroma, or your other favorite ActivityPub-powered platform, and search for the fediverse handle from your settings page. (**Note**: you can also search for the blog URL, instead of the handle.) Finally, click the "Follow" button. This will make sure you receive future posts in your timeline, where you can then favorite or boost them to your followers. ## Note about changing your username -If you change your username, a new fediverse handle will be created. The previous fediverse handle will stop being updated. Anyone who was following your previous fediverse handle will not automatically be following the new one. This means they will have to follow the new handle in order to receive your most recent posts. +If you change your username, a new fediverse handle will be created, and the previous fediverse handle will stop receiving new posts. Anyone who was following your previous fediverse handle will have to follow the new one in order to receive your most recent posts. ## Demo From 00ee0e9b91e6a11f4a961e46d067e39767d09427 Mon Sep 17 00:00:00 2001 From: Matt Baer Date: Mon, 13 Jan 2020 09:59:31 -0500 Subject: [PATCH 3/3] Add some formatting to Federation guide --- writer/federation.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/writer/federation.md b/writer/federation.md index a651d98..415278d 100644 --- a/writer/federation.md +++ b/writer/federation.md @@ -4,11 +4,11 @@ WriteFreely supports federation via ActivityPub, a protocol spoken by popular pl ## Finding your handle -To find your handle, go into your blog's settings. Under _URL_ will be your blog's fediverse handle, following the format blog@instance. +To find your handle, go into your blog's settings. Under _URL_ will be your blog's fediverse handle, following the format `@blog@instance.com`. ## Following your blog -To follow your blog, open Mastodon, Pleroma, or your other favorite ActivityPub-powered platform, and search for the fediverse handle from your settings page. (**Note**: you can also search for the blog URL, instead of the handle.) Finally, click the "Follow" button. This will make sure you receive future posts in your timeline, where you can then favorite or boost them to your followers. +To follow your blog, open Mastodon, Pleroma, or your other favorite ActivityPub-powered platform, and search for the fediverse handle from your settings page. (**Note**: you can also search for the blog URL, instead of the handle.) Finally, click the "Follow" button. This will make sure you receive future posts in your timeline, where you can then _favorite_ or _boost_ them to your followers. ## Note about changing your username