Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Fix DID and NSID local links in glossary #368

Open
wants to merge 2 commits into
base: main
Choose a base branch
from
+14 −14
Open

Fix DID and NSID local links in glossary #368

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
8780bbd
fix local link to did
Nov 26, 2024
c5eacb1
fix nsid links
Nov 28, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions src/app/[locale]/guides/glossary/en.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ The name is also a play on the "@" symbol, aka the "at" symbol, since atproto is

## PDS (Personal Data Server)

A PDS, or Personal Data Server, is a server that hosts a user. A PDS will always store the user's [data repo](#data-repo) and signing keys. It may also assign the user a [handle](#handle) and a [DID](#did). Many PDSes will host multiple users.
A PDS, or Personal Data Server, is a server that hosts a user. A PDS will always store the user's [data repo](#data-repo) and signing keys. It may also assign the user a [handle](#handle) and a [DID](#did-decentralized-id). Many PDSes will host multiple users.

A PDS communicates with [AppViews](#appview) to run applications. A PDS doesn't typically run any applications itself, though it will have general account management interfaces such as the OAuth login screen. PDSes actively sync their [data repos](#data-repo) with [Relays](#relay).

Expand All @@ -47,16 +47,16 @@ Lexicon's sole purpose is to help developers build compatible software.

## Data Repo

The "data repository" or "repo" is the public dataset which represents a user. It is comprised of [collections](#collection) of JSON [records](#record) and unstructured [blobs](#blob). Every repo is assigned a single permanent [DID](#did) which identifies it. Repos may also have any number of [domain handles](#handle) which act as human-readable names.
The "data repository" or "repo" is the public dataset which represents a user. It is comprised of [collections](#collection) of JSON [records](#record) and unstructured [blobs](#blob). Every repo is assigned a single permanent [DID](#did-decentralized-id) which identifies it. Repos may also have any number of [domain handles](#handle) which act as human-readable names.

Data repositories are signed merkle trees. Their signatures can be verified against the key material published under the repo's [did](#did).
Data repositories are signed merkle trees. Their signatures can be verified against the key material published under the repo's [did](#did-decentralized-id).

- [An introduction to data repos](/guides/data-repos)
- [Repository spec](/specs/repository)

## Collection

The "collection" is a bucket of JSON [records](#record) in a [data repository](#data-repo). They support ordered list operations. Every collection is identified by an [NSID](#nsid) which is expected to map to a [Lexicon](#lexicon) schema.
The "collection" is a bucket of JSON [records](#record) in a [data repository](#data-repo). They support ordered list operations. Every collection is identified by an [NSID](#nsid-namespaced-id) which is expected to map to a [Lexicon](#lexicon) schema.

## Record

Expand Down
10 changes: 5 additions & 5 deletions src/app/[locale]/guides/glossary/ja.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ AT プロトコルは、「Authenticated Transfer Protocol」の略です。こ

## PDS (パーソナル データ サーバー)

PDS (パーソナル データ サーバー) は、ユーザーをホストするサーバーです。PDS は常にユーザーの [データ リポジトリ](#data-repo) と署名キーを保存します。また、ユーザーに [ハンドル](#handle) と [DID](#did) を割り当てることもあります。多くの PDS は複数のユーザーをホストします。
PDS (パーソナル データ サーバー) は、ユーザーをホストするサーバーです。PDS は常にユーザーの [データ リポジトリ](#data-repo) と署名キーを保存します。また、ユーザーに [ハンドル](#handle) と [DID](#did-分散-id) を割り当てることもあります。多くの PDS は複数のユーザーをホストします。

PDS は [AppViews](#appview) と通信してアプリケーションを実行します。PDS は通常、それ自体ではアプリケーションを実行しませんが、OAuth ログイン画面などの一般的なアカウント管理インターフェイスを備えています。PDS は [データ リポジトリ](#data-repo) を [リレー](#relay) と積極的に同期します。

Expand All @@ -47,16 +47,16 @@ Lexicon の唯一の目的は、開発者が互換性のあるソフトウェア

## データ リポジトリ

「データ リポジトリ」または「リポジトリ」は、ユーザーを表すパブリック データセットです。これは、JSON [レコード](#record) と非構造化 [blob](#blob) の [コレクション](#collection) で構成されています。すべてのリポジトリには、それを識別する 1 つの永続的な [DID](#did) が割り当てられます。リポジトリには、人間が読める名前として機能する [ドメイン ハンドル](#handle) をいくつでも持つことができます。
「データ リポジトリ」または「リポジトリ」は、ユーザーを表すパブリック データセットです。これは、JSON [レコード](#record) と非構造化 [blob](#blob) の [コレクション](#collection) で構成されています。すべてのリポジトリには、それを識別する 1 つの永続的な [DID](#did-分散-id) が割り当てられます。リポジトリには、人間が読める名前として機能する [ドメイン ハンドル](#handle) をいくつでも持つことができます。

データ リポジトリは、署名されたマークル ツリーです。その署名は、リポジトリの [did](#did) で公開されたキー マテリアルに対して検証できます。
データ リポジトリは、署名されたマークル ツリーです。その署名は、リポジトリの [did](#did-分散-id) で公開されたキー マテリアルに対して検証できます。

- [データ リポジトリの概要](/guides/data-repos)
- [リポジトリ仕様](/specs/repository)

## コレクション

「コレクション」は、[データ リポジトリ](#data-repo) 内の JSON [レコード](#record) のバケットです。順序付きリスト操作をサポートします。すべてのコレクションは、[NSID](#nsid) によって識別され、[Lexicon](#lexicon) スキーマにマップされることが想定されています。
「コレクション」は、[データ リポジトリ](#data-repo) 内の JSON [レコード](#record) のバケットです。順序付きリスト操作をサポートします。すべてのコレクションは、[NSID](#nsid-名前空間-id) によって識別され、[Lexicon](#lexicon) スキーマにマップされることが想定されています。

## レコード

Expand Down Expand Up @@ -115,4 +115,4 @@ DAG-CBOR は、[atproto](#at-protocol) で使用されるシリアル化形式

XRPC は非推奨の用語ですが、歴史的には [atproto](#at-protocol) の HTTP 使用法を説明するために使用されていました。これは「組織間リモート プロシージャ コール」の略語ですが、実際には HTTP を使用しているだけなので、この用語を発明したことを後悔しています。

- [HTTP API 仕様](/specs/xrpc)
- [HTTP API 仕様](/specs/xrpc)
10 changes: 5 additions & 5 deletions src/app/[locale]/guides/glossary/pt.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ O nome também é um trocadilho com o símbolo "@", também conhecido como símb

## PDS (Personal Data Server)

Um PDS, ou Personal Data Server, é um servidor que hospeda um usuário. Um PDS sempre armazenará o [data repo](#data-repo) e as chaves de assinatura do usuário. Ele também pode atribuir ao usuário um [handle](#handle) e um [DID](#did). Muitos PDSes hospedarão vários usuários.
Um PDS, ou Personal Data Server, é um servidor que hospeda um usuário. Um PDS sempre armazenará o [data repo](#data-repo) e as chaves de assinatura do usuário. Ele também pode atribuir ao usuário um [handle](#handle) e um [DID](#did-decentralized-id). Muitos PDSes hospedarão vários usuários.

Um PDS se comunica com [AppViews](#appview) para executar aplicativos. Um PDS normalmente não executa nenhum aplicativo, embora tenha interfaces gerais de gerenciamento de conta, como a tela de login do OAuth. Os PDSes sincronizam ativamente seus [data repos](#data-repo) com [Relays](#relay).

Expand All @@ -47,16 +47,16 @@ O único propósito do Lexicon é ajudar os desenvolvedores a criar software com

## Data Repo

O "repositório de dados" ou "repo" é o conjunto de dados público que representa um usuário. Ele é composto de [coleções](#collection) de [registros](#record) JSON e [blobs](#blob) não estruturados. Cada repositório recebe um único [DID](#did) permanente que o identifica. Os repositórios também podem ter qualquer número de [identificadores de domínio](#handle) que atuam como nomes legíveis por humanos.
O "repositório de dados" ou "repo" é o conjunto de dados público que representa um usuário. Ele é composto de [coleções](#collection) de [registros](#record) JSON e [blobs](#blob) não estruturados. Cada repositório recebe um único [DID](#did-decentralized-id) permanente que o identifica. Os repositórios também podem ter qualquer número de [identificadores de domínio](#handle) que atuam como nomes legíveis por humanos.

Os repositórios de dados são árvores merkle assinadas. Suas assinaturas podem ser verificadas em relação ao material-chave publicado sob o [did](#did) do repositório.
Os repositórios de dados são árvores merkle assinadas. Suas assinaturas podem ser verificadas em relação ao material-chave publicado sob o [did](#did-decentralized-id) do repositório.

- [Uma introdução aos repositórios de dados](/guides/data-repos)
- [Especificação do repositório](/specs/repository)

## Collection

A "coleção" é um bucket de [registros](#record) JSON em um [repositório de dados](#data-repo). Eles suportam operações de lista ordenada. Cada coleção é identificada por um [NSID](#nsid) que deve ser mapeado para um esquema [Lexicon](#lexicon).
A "coleção" é um bucket de [registros](#record) JSON em um [repositório de dados](#data-repo). Eles suportam operações de lista ordenada. Cada coleção é identificada por um [NSID](#nsid-namespaced-id) que deve ser mapeado para um esquema [Lexicon](#lexicon).

## Record

Expand Down Expand Up @@ -115,4 +115,4 @@ DAG-CBOR é um formato de serialização usado por [atproto](#at-protocol). Ele

XRPC é um termo que estamos descontinuando, mas ele foi historicamente usado para descrever o tipo de uso de HTTP [atproto](#at-protocol). Ele significa "Cross-organizational Remote Procedure Calls" e lamentamos tê-lo inventado, porque na verdade estamos apenas usando HTTP.

- [HTTP API spec](/specs/xrpc)
- [HTTP API spec](/specs/xrpc)