Skip to content

Commit adf8e35

Browse files
authored
Merge pull request #1 from d3ol-dev/main
first version for blacksky user documentation
2 parents dbdc240 + bec3fd6 commit adf8e35

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

45 files changed

+273
-792
lines changed

.gitignore

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -18,3 +18,7 @@
1818
npm-debug.log*
1919
yarn-debug.log*
2020
yarn-error.log*
21+
22+
# Lock Files
23+
bun.lock
24+
yarn.lock

blog/2019-05-28-first-blog-post.md

Lines changed: 0 additions & 12 deletions
This file was deleted.

blog/2019-05-29-long-blog-post.md

Lines changed: 0 additions & 44 deletions
This file was deleted.

blog/2021-08-01-mdx-blog-post.mdx

Lines changed: 0 additions & 24 deletions
This file was deleted.
Binary file not shown.

blog/2021-08-26-welcome/index.md

Lines changed: 0 additions & 29 deletions
This file was deleted.

blog/authors.yml

Lines changed: 0 additions & 23 deletions
This file was deleted.

blog/tags.yml

Lines changed: 0 additions & 19 deletions
This file was deleted.

docs/blacksky-info/_category_.json

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
{
2+
"label": "General Information",
3+
"position": 2,
4+
"link": {
5+
"type": "generated-index"
6+
}
7+
}
8+
Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
# Blacksky Feeds and Hashtags
2+
3+
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.
4+
5+
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).
6+
7+
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.
8+
9+
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).
10+
11+
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.
12+
13+
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).
Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
# Blacksky Moderation
2+
3+
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.
4+
[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
5+
6+
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)
7+
8+
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.
9+
10+
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.
11+
12+
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.
13+
14+
We might label the content, add the user to the Green List, and/or prevent the user from viewing the Blacksky feed.
15+
16+
![A screenshot of the moderation list called "Green List"](../../static/img/exampleBskyPostSeven.png)
17+
*Here's what the moderation list "Green List" looks like*
18+
19+
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.
20+
21+
See something or someone in the Blacksky feeds that doesn’t belong?\
22+
\
23+
Report that to @blacksky.app.
24+
See someone harassing Black folks anywhere on Bluesky?\
25+
\
26+
Report that to @blacksky.app.\
27+
\
28+
See something that could otherwise harm Black folks (e.g. screenshots of racist posts on X)? Report to @blacksky.app
29+
30+
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.
31+
32+
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.
33+
34+
Any accounts blocked by “Banned From TV” will see the following when trying to load any of the Blacksky feeds:
35+
![a screenshot of a Bluesky post that reads ""](../../static/img/exampleBskyPostThree.png)
Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
# Curating Your Experience
2+
3+
How you curate your skyline is on you. [Blacksky](https://bsky.app/profile/blacksky.app) recommends the following best practices:
4+
- Do not use the #AddToBlacksky and #Blacksky hashtags unnecessarily. Using hashtags in Bluesky makes your posts easy to search for, but also allows for misuse.
5+
- You only need to use #AddToBlacksky once to have your posts shown in the feed. We recommend deleting that initial post after you are on the feed in order to make it harder to search for and be used accidentally or maliciously.
6+
- We recommend subscribing to and performing a “Block All” using the Green List Feed.
7+
8+
If you’ve updated your personal moderation settings to hide sexual content but it’s still coming through the feeds, you can report the post to the Blacksky Moderation Service to have it removed if it’s spam or have them label it as sexual content.
9+
10+
You must be subscribed to the Blacksky Moderation Service to do so. To learn more, see How Do I Subscribe to the Blacksky Moderation Service Labeler?

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

Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,38 @@
1+
# Joining Blacksky Feeds and Moderation Tools
2+
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.
3+
## Feeds
4+
There are several feeds created by Blacksky Algorithms:
5+
1. *[Blacksky](https://bsky.app/profile/rudyfraser.com/feed/blacksky)*
6+
2. *[Blacksky: Trending](https://bsky.app/profile/rudyfraser.com/feed/blacksky-trend)*
7+
3. *[Blackademics](https://bsky.app/profile/rudyfraser.com/feed/blacksky-edu)*
8+
9+
> Note: You may see that the feeds are authored by "@rudyfraser.com". Those are the right feeds.
10+
11+
### Joining a Blacksky Feed
12+
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.
13+
14+
![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)
15+
16+
### Leaving a Blacksky Feed
17+
Create a post and include the #RemoveFromBlacksky hashtag. All posts after will NOT be included in any of the Blacksky feeds.
18+
19+
![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)
20+
21+
### Pinning a Feed
22+
1. Open the [Bluesky](www.bsky.app) app.
23+
2. Navigate to the search page.
24+
3. Type in the title of any of the feeds previously mentioned.
25+
4. Click on the "+" to join this feed.
26+
27+
## Moderation Tools
28+
29+
### Labeler
30+
1. Go to the [Blacksky profile](https://bsky.app/profile/blacksky.app) on Bluesky.
31+
2. Click Subscribe to Labeler.
32+
3. After subscribing, all posts on Bluesky will be labeled with a warning (Warn setting) by default:
33+
- **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.
34+
- **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.
35+
36+
![A screenshot what the moderation labels look like](../../static/img/exampleBskyPostSix.png)
37+
38+
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

Lines changed: 73 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,73 @@
1+
---
2+
sidebar_position: 1
3+
slug: /
4+
---
5+
6+
# Introduction
7+
Blacksky Algorithms builds open-source, community-driven infrastructure for decentralized social media. Our mission is to empower communities with tools for safety, governance, and control over their online spaces. This documentation is designed to help new users understand what Blacksky offers and how to get started with our feeds and moderation services.
8+
9+
## Frequently Asked Questions
10+
11+
### What is the AT Protocol?
12+
The Authenticated Transfer Protocol (aka atproto) is the decentralized social networking protocol that is used to build open social media applications, like Bluesky.
13+
14+
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.
15+
16+
### How do I Add Myself to the Blacksky Feed?
17+
See [Joining a Blacksky Feed](/docs/blacksky-info/how-to-add.md#Joining-a-Blacksky-Feed).
18+
19+
### How do I Remove Myself from the Blacksky Feed or Starter Pack?
20+
See [Leaving a Blacksky Feed](/docs/blacksky-info/how-to-add.md#Leaving-a-Blacksky-Feed).
21+
22+
### How do I Report a Post to the Blacksky Moderation Service?
23+
To report a post:
24+
1. Click the … icon on the bottom-right of the post.
25+
2. Select **Report Post**.
26+
3. Select an option under "Why should this post be reviewed?" Note that at the time of writing, the only reasons that will allow you to select Blacksky as your moderator are "*Unwanted Sexual Content*", "*Anti-Social Behavior*", "*Illegal and Urgent*", and "*Other*".
27+
4. On the "**Select Moderation Service**" step that appears, select BlackSky Moderation.
28+
5. Click submit report. For "Other" please always submit a comment or details so we know why something is being reported.
29+
30+
> If you'd like to report to additional services like reporting to Bluesky's Moderation Service, repeat these steps and select the appropriate moderation service..
31+
32+
### How do I know if I got banned?
33+
If this is the only post you're seeing in the Blacksky feed, then your access to the feed has been restricted due to suspicion that you are using the feed to target and harass marginalized users.
34+
35+
![A screenshot showing what users banned from the Blacksky feed would see.](../static/img/exampleBskyPostThree.png)
36+
37+
### Can I submit feedback for Blacksky?
38+
Yes! We're constantly innovating and evolving based on user feedback from our community. To submit feedback about Blacksky, simply write an email to [[email protected]](mailto:rudy%40blacksky.app?subject=Feedback%20For%20Blacksky)
39+
40+
> Please note, we are only taking feedback for improvements and features to the feed, moderation services, etc. Do not use this form to report malicious or harassment posts.
41+
42+
## Getting Involved with Blacksky
43+
First, we appreciate you showing interest in contributing to the rsky project!
44+
45+
This project heavily involves the AT Protocol. There are resources attached to this section that you can use to gain a better understanding.
46+
47+
* [ATProto for Distributed Systems Engineers](https://atproto.com/articles/atproto-for-distsys-engineers)
48+
* [AT Protocol Specifications](https://atproto.com/#resources)
49+
* [Official Bluesky PDS (In TypeScript)](https://github.com/bluesky-social/atproto/tree/main/packages/pds)
50+
* [Official Blacksky PDS (In Rust)](https://github.com/blacksky-algorithms/rsky/tree/main/rsky-pds)
51+
* [Bigsky, the official Bluesky Relay](https://github.com/bluesky-social/indigo/tree/main/cmd/bigsky)
52+
* It can be accessed at https://relay1.us-east.bsky.network, but the popular option is to use https://bsky.network/.
53+
* [Jetstream, a bandwidth-friendly relay](https://github.com/bluesky-social/jetstream)
54+
* [Official Bluesky Appview](https://github.com/bluesky-social/atproto/tree/main/packages/bsky)
55+
* [Example AppView](https://github.com/bluesky-social/statusphere-example-app/tree/main)
56+
* [Constellation, a global backlink indexing tool](https://github.com/at-microcosm/links/tree/main/constellation)
57+
58+
59+
At a high level, the Authenticated Transfer Protocol (aka AT Protocol, ATProto, atproto) is a generic, federated protocol for building open social media appliactions. Personal Data Servers (or PDSs) store user data and handle identity. Relays aggregate and distribute data across the network. App Views aggregate data from the relays, for it to be used in feeds.
60+
61+
We understand that not everyone is in a position to give technical contributions to the project. We want to outline some other ways you can contribute. Don't feel pressured if you aren't in a position to participate in upcoming suggestions. Simply giving us a "star", or sharing the word about the project is appreciated.
62+
63+
Some other ways you can contribute to the project include:
64+
- [Financial Contributions](https://opencollective.com/blacksky)
65+
- Updating and/or Translating Documentation
66+
- Writing Tutorials
67+
- Adapting the Project for Specific Regions
68+
- Community Support
69+
- Design Elements
70+
- User Experience
71+
- User Interface
72+
73+
If there are any other ways you would like to contribute to the project. Consider reaching out to [the team](mailto:rudy%40blacksky.app?subject=Other%20Ways%20to%20Contribute) to see if there is a fit!

docs/blacksky-misc/_category_.json

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
{
2+
"label": "Additional Information",
3+
"position": "3",
4+
"link": {
5+
"type": "generated-index"
6+
}
7+
}

0 commit comments

Comments
 (0)