Skip to content

Commit 29a78a1

Browse files
committed
fix: PR comment updates
1 parent 2576e22 commit 29a78a1

File tree

1 file changed

+10
-4
lines changed

1 file changed

+10
-4
lines changed

docs/content/4.integrations/1.atmosphere.md

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ _npmx.dev_ site architecture as it pertains to the ATProtocol (ATProto) ecosyste
1313

1414
## Atmosphere
1515

16-
The Atmosphere is the interconnected web of applications that all run on the ATProto. The primary benefits of this integration for _npmx.dev_ are the social features that connect us to the tens of millions of users on the ATProto social graph. Per the docs site:
16+
The Atmosphere is the interconnected web of applications that all run on ATProto. The primary benefits of this integration for _npmx.dev_ are the social features that connect us to the tens of millions of users on the ATProto social graph. Per the docs site:
1717

1818
> The AT Protocol is an open, decentralized network for building social applications.
1919
@@ -23,7 +23,7 @@ The Atmosphere is the interconnected web of applications that all run on the ATP
2323

2424
These are the essential components that allow for _npmx.dev_ to exist as an app on the Atmosphere:
2525

26-
1. **App View** - _npmx.dev_ site
26+
1. **Domain** - _npmx.dev_ site
2727
2. **OAuth** - Required for interacting with the Atmosphere
2828
3. **Constellation** - A global atproto backlink index
2929
4. **Lexicons** - Schema definition language
@@ -33,7 +33,7 @@ These are the essential components that allow for _npmx.dev_ to exist as an app
3333

3434
For more details refer to the official ATProto docs [here](https://atproto.com/guides/the-at-stack).
3535

36-
### App View
36+
### Domain
3737

3838
The _npmx.dev_ app is the frontend domain for the site which acts as a third-party browser for the extant [npmjs site](https://www.npmjs.com) but prioritized around high developer experience (DX) and native-like performance. As it concerns the idiomatic Atmosphere stack, it serves as the client entry point and enables user controls for `@npmx.social` profiles.
3939

@@ -51,12 +51,16 @@ For more details refer to the official ATProto docs [here](https://atproto.com/s
5151

5252
Constellation serves as the API orchestration layer and backend indexer. It acts as a bridge between _npmx.dev_ specific data structures and the wider ATProto network. Specifically, it indexes backlinks, aggregates app-view data, and manages the caching layer to reduce load on individual PDS instances during high-traffic events.
5353

54+
For more details refer to the official Constellation site [here](https://constellation.microcosm.blue/).
55+
5456
### Lexicons
5557

5658
This is the glue that makes _npmx.dev_ data understandable to other ATProto apps. We utilize custom Lexicons to define the schema for _npmx.dev_ specific record types, such as our social features, package reviews, or documentation comments.
5759

5860
> Lexicon is a schema definition language used to describe atproto records, HTTP endpoints (XRPC), and event stream messages.
5961
62+
For the _npmx.dev_ specific implementation you can see them in the repo [here](https://atproto.com/specs/lexicon) and as they become more fixed we will publish their accompanying schemas.
63+
6064
For more details refer to the official ATProto docs [here](https://atproto.com/specs/lexicon).
6165

6266
### Personal Data Servers (PDS)
@@ -71,7 +75,9 @@ For more details refer to the official ATProto docs [here](https://atproto.com/g
7175

7276
### Standard Site Sync
7377

74-
The mechanism for ensuring state consistency between _npmx.dev_ and our self-hosted PDS. Standard Site Sync acts as a specialized repository synchronization layer that translates changes from the _npmx.dev_ platform, such as when we publish a new blog post in the form of a Markdown file, into valid ATProto records that are then pushed to a user's PDS. This ensures that content created on _npmx.dev_ lives permanently in the user's data repository.
78+
Standard Site Sync acts as a specialized repository synchronization layer that translates changes from the _npmx.dev_ platform, such as when we publish a new blog post in the form of a Markdown file, into valid ATProto records that are then pushed to a user's PDS. It is the mechanism for maintaining state consistency between _npmx.dev_ and our self-hosted PDS, which ensures that content created on _npmx.dev_ lives permanently in the user's data repository.
79+
80+
For more details refer to the official Standard Site [here](https://standard.site).
7581

7682
### Bluesky Social Graph
7783

0 commit comments

Comments
 (0)