refactor: made tweaks to documentation

Author: d3ol-dev

docs/blacksky-info/blacksky-feeds-hashtags.md

@@ -1,13 +1,13 @@
-# Understanding Blacksky Feeds and Hashtags
+# Blacksky Feeds and Hashtags
 
-Within Bluesky you can view content based on feeds or by hashtag. It is a common mistake to assume that custom feeds in Bluesky are similar to a subreddit. 
+Within Bluesky you can view content based on feeds or by hashtag. It is a common mistake to assume that custom feeds in Bluesky are similar to a subreddit.
 
-They are not. Custom feeds in Bluesky are aggregators of content, not forums. You cannot post exclusively to any one feed at this time. To learn more about Bluesky feeds and hashtags, see XXX and XXX.
+They are not. Custom feeds in Bluesky are aggregators of content, not forums. You cannot post exclusively to any one feed at this time. Click to learn more about [Bluesky feeds](https://bsky.social/about/blog/7-27-2023-custom-feeds).
 
-So, clicking the #Blacksky hashtag is not the same as using the official Blacksky Feed. The feed is chronologically ordered and the content is curated through human moderation, automation, and some pre-filtering logic. 
+So, clicking the #Blacksky hashtag is not the same as using the official Blacksky Feed. The feed is chronologically ordered and the content is curated through human moderation, automation, and some pre-filtering logic.
 
-The community also proactively reports content to our Blacksky Moderation Service [@blacksky.app](https://bsky.app/profile/blacksky.app). Also, see How Do I Add Myself to the Blacksky Feed?
+The community also proactively reports content to our Blacksky Moderation Service [@blacksky.app](https://bsky.app/profile/blacksky.app). Also, see [How Do I Add Myself to the Blacksky Feed](docs/blacksky-info/how-to-add.md).
 
-A starter pack is a list of users and feeds that help new users find community quicker. The Blacksky Starter Pack is a curated list of the 50 most popular and active accounts from the Blacksky feeds. 
+A starter pack is a list of users and feeds that help new users find community quicker. The Blacksky Starter Pack is a curated list of the 50 most popular and active accounts from the Blacksky feeds.
 
 Also includes Blacksky, Blacksky Trending, and the Blackademics feeds. To learn more about Bluesky starter packs, visit Bluesky's [blog post](https://bsky.social/about/blog/06-26-2024-starter-packs).

docs/blacksky-info/blacksky-moderation.md

@@ -1,35 +1,35 @@
-# Understanding Blacksky Moderation
+# Blacksky Moderation
 
-Any content labeled by Bluesky's AI-based labeler is automatically filtered out of the feed as soon as it is labeled. This usually occurs at the time of posting, but can happen later. To learn more about Bluesky’s labeler, see XXX.
+Any content labeled by Bluesky's AI-based labeler is automatically filtered out of the feed as soon as it is labeled. This usually occurs at the time of posting, but can happen later.
+[Defined by Bluesky](https://bsky.social/about/blog/03-12-2024-stackable-moderation), labels are annotations on users and content. They can be used to hide, warn, and categorize [posts, and users on] the network
 
-The Blacksky Moderation Service, @blacksky.app, is where you can report posts for antiblackness and misogynoir. The service is also a labeler that you can subscribe to in order to be warned about harmful or insensitive content. Also see, How Do I Subscribe to the Blacksky Moderation Service Labeler?
+The Blacksky Moderation Service, @blacksky.app, is where you can report posts for antiblackness and misogynoir. The service is also a labeler that you can subscribe to in order to be warned about harmful or insensitive content. Also see, [How Do I Subscribe to the Blacksky Moderation Service Labeler](/docs/blacksky-info/how-to-add.md#labeler)
 
-Other content that doesn't belong in the feed can be reported to the @blacksky.app, where a team of moderators will review the content for removal from the feed.
+Other content that doesn't belong in the feed can be reported to [@blacksky.app](https://bsky.app/profile/blacksky.app), where a team of moderators will review the content for removal from the feed.
 
-Antiblack content or misogynoir that appears elsewhere in any of the official Blacksky feeds can also be reported to @blacksky.app in order to protect Blacksky from malicious content from any source.
+Antiblack content or misogynoir that appears elsewhere in any of the official Blacksky feeds should be reported to [@blacksky.app](https://bsky.app/profile/blacksky.app) in order to protect Blacksky from malicious content from any source.
 
-Blacksky also filters out sexually explicit images based on labels from the official Bluesky Moderation Service (@bsky.app), and the main Blacksky and Blacksky Trending feeds.
+Blacksky also filters out sexually explicit images based on labels from the official Bluesky Moderation Service [@moderation.bsky.app](https://bsky.app/profile/moderation.bsky.app), and the main Blacksky and Blacksky Trending feeds.
 
 We might label the content, add the user to the Green List, and/or prevent the user from viewing the Blacksky feed.
 
+![A screenshot of the moderation list called "Green List"](../../static/img/exampleBskyPostSeven.png)
+*Here's what the moderation list "Green List" looks like*
+
 We recommend that you do not publicly “flag” posts (e.g., repost or engage via a reply), as harassers will use that to target you in the future or start conflict within the community. Using @blacksky.app to report harassers ensures your confidentiality and protects your peace on Blacksky and Bluesky.
 
-See something or someone in the Blacksky feeds that doesn’t belong? Report that to @blacksky.app.
-See someone harassing Black folks anywhere on Bluesky? Report that to @blacksky.app.
+See something or someone in the Blacksky feeds that doesn’t belong?\
+\
+Report that to @blacksky.app.
+See someone harassing Black folks anywhere on Bluesky?\
+\
+Report that to @blacksky.app.\
+\
 See something that could otherwise harm Black folks (e.g. screenshots of racist posts on X)? Report to @blacksky.app
 
-Also, see How to Do I Report a Post to the Blacksky Moderation Service (blacksky.app)? and XXX.
+Also, see [How to Do I Report a Post to the Blacksky Moderation Service](/docs/blacksky-intro.md#How-do-I-Report-a-Post-to-the-Blacksky-Moderation-Service?) (blacksky.app)? and XXX.
 
 The moderation service gives you a discrete way to report harmful content but it also allows Blacksky to enable features that protect the community. For example, the Blacksky “Banned from TV” feature allows for certain accounts that are reported to be blocked from even seeing the feed.
 
-Any accounts blocked by “Banned From TV” see the following when trying to load any of the Blacksky feeds:
-[image of blocked user]
-
-## How Do I Subscribe to the Blacksky Moderation Service Labeler?
-1. Go to the [Blacksky profile](https://bsky.app/profile/blacksky.app) on Bluesky.
-2. Click Subscribe to Labeler.
-3. After subscribing, all posts on Bluesky will be labeled with a warning (Warn setting) by default:
-- **Misogynoir**: Content that expresses hatred, bias, or prejudice against Black women, specifically where racism, sexism, and/or transphobia intersect. This includes sexual harassment, objectification, and targeted attacks on Black women’s identity or appearance.
-- **Antiblack Harassment**: Content that targets individuals or groups based on their Black identity with derogatory, hateful, or dehumanizing language or imagery. This label is applied to content that perpetuates harmful stereotypes, slurs, or direct harassment aimed at Black individuals or communities.
-
-You can turn this Off or change the Warn to Hide. Selecting Hide will hide any posts with the label from your feeds.
+Any accounts blocked by “Banned From TV” will see the following when trying to load any of the Blacksky feeds:
+![a screenshot of a Bluesky post that reads ""](../../static/img/exampleBskyPostThree.png)

docs/blacksky-info/how-to-add.md

@@ -1,12 +1,38 @@
-# How to join Blacksky feeds?
-
-Currently there are two feeds managed by Blacksky, *Blacksky*, and *Blacksky: Trending*.
+# Joining Blacksky Feeds and Moderation Tools
+This section outlines how to join feeds and moderation tools. Although this section uses Blacksky feeds and moderation examples, this applies to any other available feed or moderation tool.
+## Feeds
+There are several feeds created by Blacksky Algorithms:
+1. *[Blacksky](https://bsky.app/profile/rudyfraser.com/feed/blacksky)*
+2. *[Blacksky: Trending](https://bsky.app/profile/rudyfraser.com/feed/blacksky-trend)*
+3. *[Blackademics](https://bsky.app/profile/rudyfraser.com/feed/blacksky-edu)*
 
 > Note: You may see that the feeds are authored by "@rudyfraser.com". Those are the right feeds.
 
+### Joining a Blacksky Feed
+Create a post and include the #AddToBlacksky hashtag (This only needs to be done once). All posts after will be included in the Blacksky feed.
+
+![A screenshot of post on Bluesky including text that states "This is an example of a post", and "#AddToBlacksky". This is to showcase how a user can get their posts included in the Blacksky feed.](../../static/img/exampleBskyPost.png)
+
+### Leaving a Blacksky Feed
+Create a post and include the #RemoveFromBlacksky hashtag. All posts after will NOT be included in any of the Blacksky feeds.
+
+![A screenshot of post on Bluesky including text that states "This is another example post", and "#RemoveFromBlacksky". This is to showcase how a user can get their posts included in the Blacksky feed](../../static/img/exampleBskyPostTwo.png)
+
+### Pinning a Feed
 1. Open the [Bluesky](www.bsky.app) app.
 2. Navigate to the search page.
-3. Type in the word "Blacksky". You should see *Blacksky*, and *Blacksky: Trending*.
+3. Type in the title of any of the feeds previously mentioned.
 4. Click on the "+" to join this feed.
 
-Congrats! You have joined the Blacksky feeds.
+## Moderation Tools
+
+### Labeler
+1. Go to the [Blacksky profile](https://bsky.app/profile/blacksky.app) on Bluesky.
+2. Click Subscribe to Labeler.
+3. After subscribing, all posts on Bluesky will be labeled with a warning (Warn setting) by default:
+- **Misogynoir**: Content that expresses hatred, bias, or prejudice against Black women, specifically where racism, sexism, and/or transphobia intersect. This includes sexual harassment, objectification, and targeted attacks on Black women’s identity or appearance.
+- **Antiblack Harassment**: Content that targets individuals or groups based on their Black identity with derogatory, hateful, or dehumanizing language or imagery. This label is applied to content that perpetuates harmful stereotypes, slurs, or direct harassment aimed at Black individuals or communities.
+
+![A screenshot what the moderation labels look like](../../static/img/exampleBskyPostSix.png)
+
+You can turn this Off or change the Warn to Hide. Selecting Hide will hide any posts with the label from your feeds.

docs/blacksky-intro.md

@@ -14,17 +14,12 @@ The Authenticated Transfer Protocol (aka atproto) is the decentralized social ne
 Here's a [link to a Bluesky blog](https://bsky.social/about/blog/02-22-2024-open-social-web) post that explains what it is, and why it differs from other social apps you may be used to.
 
 ### How do I Add Myself to the Blacksky Feed?
-Create a post and include the #AddToBlacksky hashtag (This only needs to be done once). All posts after will be included in the Blacksky feed.
-
-![A screenshot of post on Bluesky including text that states "This is an example of a post", and "#AddToBlacksky". This is to showcase how a user can get their posts included in the Blacksky feed.](../static/img/exampleBskyPost.png)
+See [Joining a Blacksky Feed](/docs/blacksky-info/how-to-add.md#Joining-a-Blacksky-Feed).
 
 ### How do I Remove Myself from the Blacksky Feed or Starter Pack?
-Create a post and include the #RemoveFromBlacksky hashtag. All posts after will NOT be included in any of the Blacksky feeds.
-
-![A screenshot of post on Bluesky including text that states "This is another example post", and "#RemoveFromBlacksky". This is to showcase how a user can get their posts included in the Blacksky feed](../static/img/exampleBskyPostTwo.png)
+See [Leaving a Blacksky Feed](/docs/blacksky-info/how-to-add.md#Leaving-a-Blacksky-Feed).
 
 ### How do I Report a Post to the Blacksky Moderation Service?
-
 To report a post:
 1. Click the … icon on the bottom-right of the post.
 2. Select **Report Post**.