Skip to content

Commit

Permalink
Information Architecture v3 (XRPLF#1934)
Browse files Browse the repository at this point in the history 
* Update look up escrows to remove redundant info about lookups via sender/destination. Modify cancel expired escrow for brevity.

* Cancel escrow: fix notes

* Add draft of updated cancel-escrow.js.

* Update intro to escrows.

* Add Escrow Tutorial

* Minor corrections

* Fix headings, add HTML

* Update escrow docs

This commit re-creates f205a92 with
some adjustments:

- Omit the accidentally-created dir full of junk
- Fix some typos and one mistake in the Escrow limitations section
- Add a table to the EscrowCreate ref to clarify valid combos of fields.

* Concept info from send-a-time-held-escrow added to escrow.md

* IA: Move "Consensus Network" files

This re-creates some work from the original commit 56fffe0

* Rewrite escrows article (re-created)

This commit re-creates relevant work from the following commits:

9a4a588 Update escrow.md context info
e1b017d Remove references to using escrow for interledger payments.

* IA: Move "XRPL servers" files

This re-creates some work from original commit 7611979

* IA: move "production readiness" files.

Re-creates work from the following commit:

6924386  Move tutorials to concepts

* New intro articles

Original commit: 56fffe0

* IA: Reorg account concepts

Re-creates some work from original commit 56fffe0

* IA: reorg transaction concepts

Original commits:
9d4eff9  WIP - reorg accounts
7611979  WIP dir. reorg

* IA: reorg consensus concepts

Original commit: 56fffe0

* IA: Reorg ledger docs

Original commit: 56fffe0

- Rephrased some details of the section

* IA: rename issuing/operational addresses page

Original commit: 56fffe0

* Moving use cases

* Fleshing out Use Cases

Note, the dactyl-config.yml file has not been fully updated.

* Clean up checks conceptual info.

* Remove redundant checks use case section

Original commit: 3c29e9c

* IA: move Dex under tokens

Original commit: d08b3ba

* Touch up stablecoin issuer use case (XRPLF#1856)

* Consolidate stablecoin use case

* Stablecoin issuer: cleanup progress through sending

* Stablecoin issuer: reorg second half

(Note: the dactyl-config.yml is not fully reconciled yet)

* Move rippled and clio tutorials into infrastructure

* Remove link to checks amendement.

* Add note to account_objects.md about commandline interface type field.

* Merge expiration case with lifecycle section.

* Interoperability Use Cases

* Add graphics to intro

* Move escrow use cases to dedicated page.

* Update use case page intros and corresponding concept info.

* Clarify meaning of direct XRP payments.

* Intro link updates

* Payment use cases

* Remove some unnecessary links in transactions section

Original commit: e6fcf4a

* Link cleanup in Tokens section

Original commit: 9588dd5

* Touch up 'Configure Peering' section

Original commit: fc8f099

* Clean up links in accounts section

Original commit: 3da5fde

* Add NFT mkt use case

* p2p payments: edits to Wallets

* Clean up payments use cases

* Refine history description

* IA: use case cleanup

* IA: reconcile servers, ledgers sections

* IA: reconcile payment types, tx, tokens

* IA: reconcile accounts section

* IA: reconcile infra

* IA: Fix most broken links

* Full Docs Index: omit from sidebar

* IA: fix up most broken links

* fix Absolute path link to internal content

* Quick updates to Software Ecosystem

* Remove some absolute links to internal resources

* Fix remaining broken links in JA target

* Contributing: tweak formatting

* Tutorials: fix some minor issues

* remove interop use cases

* remove intro image and personal references to dennis

* alphabetize-transaction-nav

* Remove unused files

* Add QS escrow tutorials

* IA: move ledgers, consensus protocol files around

* IA: update nav for new page hierarchy

* reordering of topics under new networks and servers top-nav

* Move "Naming" to "What is XRP?"

* Update dactyl-config.yml

Remove xrp.md from the TOC.

* Update list-xrp-as-an-exchange.md

Update link to what-is-xrp

* Update list-xrp-as-an-exchange.ja.md

Change link to what-is-xrp

* Update currency-formats.md

Change link to what-is-xrp

* Update currency-formats.ja.md

Change link to what-is-xrp

* Update cancel-an-expired-escrow.md

Change link to what-is-xrp

* Update paymentchannelfund.md

Change link to what-is-xml

* Update look-up-escrows.md

Change link to what-is-xrp

* Update tokens.md

change link to what-is-xrp

* Update use-payment-channels.md

* Update send-a-time-held-escrow.md

Update link to what-is-xml

* fix broken links

* Update parallel-networks.md

Change link to what-is-xml

* Update parallel-networks.ja.md

* Update invariant-checking.md

Remove link to xrp.html

* Update invariant-checking.ja.md

Remove link to xrp.html

* Update transaction-cost.md

Change link to what-is-xrp

* Update transaction-cost.ja.md

Change link to what-is-xrp

* Update send-a-conditionally-held-escrow.md

Change link to what-is-xrp

* Update stablecoin-issuer.md

Change link to what-is-xrp

* Update tokens.ja.md

Change link to what-is-xml

* Update autobridging.ja.md

Change link to what-is-xrp

* Update currency-formats.md

update text

* reorganize infrastructure nav section

* Update currency-formats.md

Try removing link altogether.

* Update currency-formats.ja.md

Remove link to what-is-xrp.html

* move commandline usage topic to infrastructure

* initial intro rewrite

* minor update to language

* IA.v3: rm Production Readiness

* Delete xrp.md

* Update xrp link in snippet

* Add redirect for old xrp.html URL

* Small edits to 'What is XRP?' article

* Add missing imgs

* XRP - copy edit per @DennisDawson

* restructure tutorials nav and pages

* fix broken links

* more broken link fixes

* Algo trading: 1st draft

* Algo trading: notes on taxes

* Algo trading: edits per review

* algo trading: fix broken link

* Ledger structure: rewrite for accuracy and clarity

* Update links to removed 'tree format' header

* Ledger Structure: Update diagrams

* Re-gen CSS for ledger structure changes

* Ledger structure: edits per review

* IA.v3: fix broken NFT links introduced by rebase

* Desktop Wallet (py): update little stuff

* Update some capacity/storage details

* contribute doc nav update

* fix image link in create diagram page

* IAv3: Fix 'Ledgers' blurb

* Update full history requirements with details from community members

* add reviewer suggestions

* Edits per @trippled review

* Apply suggestions from peer review

Co-authored-by: oeggert <[email protected]>

* FH: reword file size limit note per review

* Update software ecosystem

* updates per review

* Minor tweaks to graphics

* fixTypos

* Update content/concepts/introduction/software-ecosystem.md

Co-authored-by: Amarantha Kulkarni <[email protected]>

* Update content/concepts/introduction/software-ecosystem.md

Co-authored-by: Amarantha Kulkarni <[email protected]>

* [JA] update AccountDelete cost

* custom transactors doc

* add doc to dactyl config

* [JA] fix NonFungibleTokensV1_1 amendment status

* [JA] update NFTokenOffer page

* Remove old, unused XRP article (XRPLF#2039)

* add reviewer suggestions

* Add tooling to check for file/nav consistency

- From the repo top, run tool/check_file_consistency.py to look for
  Markdown files that exist in the "content/" directory but aren't used
  in the documentation.
- New "enforce_filenames" filter prints a warning to console when
  building, if a file's path and filename don't match expectations
  based on its place in the nav and top heading.

* File consistency checker: correctly handle filenames starting in _

* Remove unused old 'get started' and associated code

* Create Resources section & reorg some files

- Rename some files/folders based on their place in the nav
- Move a bunch of non-documentation stuff, and docs on contributing code
  and/or docs to the new "Resources" section.
- Known issue: nav spills into a second row on page widths between
  993px-1110px. To be fixed in a later CSS update, maybe along with
  making the Resources dropdown multi-column.

* Fix XRPLF#2078 code tab bug

CSS not built yet, to reduce merge conflicts. Won't have any effect
until that happens.

* fix Transaction JSON

* [JA] translate contributing contents

* fix contributing-to-documentation parent

* fix contribute-code blurb

* Top nav: add cols for Resources, fix broken links

* CSS: fix top nav overflows

* Fix broken link from redirect not in JA target

* Top nav: add Infra to article types

* Update contrib info & rename intro file

* [ja] Update link to suggested first page to translate

* [ja] fix contribute docs organization

* Run private network with docker tutorial (XRPLF#2065)

* [NO-ISSUE] Run private network with docker tutorial

Adds a tutorial page in the Infrastructure section on how to run a private XRPL network with Docker.

Please let me know if you think this is a useful page to include for developers, whether the steps are clear or not, and if you have suggestions on what can be added to it.

* Add minor link fixes and Japanese target

* Apply suggestions from code review

Co-authored-by: Amarantha Kulkarni <[email protected]>

* Add link to ripple-docker-testnet setup scripts in See Also section

* Update repo URL

---------

Co-authored-by: Amarantha Kulkarni <[email protected]>

* add intro gfx (XRPLF#2036)

* add intro gfx

* Move graphic up

* Update some graphics with their revised versions

* Add updated version of the custodial vs non-custodial graphic

---------

Co-authored-by: Amarantha Kulkarni <[email protected]>
Co-authored-by: Amarantha Kulkarni <[email protected]>

* Update to reflect current UNL publishers

* [ja] update contributing

Co-authored-by: tequ <[email protected]>

* Incorporate feedback on "What is XRP" page. (XRPLF#2099)

* Add trademark info for XRP

* Revert section to previous state

* Fix broken link (XRPLF#2101)

---------

Co-authored-by: Oliver Eggert <[email protected]>
Co-authored-by: ddawson <[email protected]>
Co-authored-by: Maria Shodunke <[email protected]>
Co-authored-by: tequ <[email protected]>
Co-authored-by: oeggert <[email protected]>
Co-authored-by: Amarantha Kulkarni <[email protected]>
Co-authored-by: develoQ <[email protected]>
Co-authored-by: Maria Shodunke <[email protected]>
Co-authored-by: Amarantha Kulkarni <[email protected]>
  • Loading branch information
@mDuo13 @oeggert
@DennisDawson @maria-robobug @tequdev @amarantha-k
10 people authored Sep 1, 2023
1 parent 31a068e commit b51bcb4
Show file tree
Hide file tree
Showing 445 changed files with 9,366 additions and 4,757 deletions.
203 changes: 1 addition & 202 deletions CONTRIBUTING.ja.md
View file
Original file line number Diff line number Diff line change
@@ -1,204 +1,3 @@
# コントリビューション

XRP Ledger開発者ポータルへのコントリビューションをご検討いただきありがとうございます。

ぜひ、皆様の力をお貸しくださいますようお願いいたします。ご協力いただくことで、XRP Ledger（XRPL）への理解を深めることができます。

また、XRPLと併せて、[インターレジャープロトコル（ILP）](https://interledger.org/)を学習することもおすすめいたします。ILPも[RippleX開発者エコシステム](https://ripplex.io)の一部です。

皆様からのプルリクエストをお待ちしております。プルリクエストのレビュー工程をできるだけ円滑に進めるためにも、本ドキュメントをお読みいただき、記載されているガイドラインに従ってください。

ご提供いただいたコードは、XRP Ledgerプロジェクトの著作物となり、MIT[ライセンス](LICENSE)に基づいて提供いたします。

## このサイトについて

XRPL開発者ポータルは、XRP Ledgerに関するドキュメントを幅広く提供します。これには、開発者がビルドを始めるためのサンプルコードなどの情報も含まれます。

## リポジトリーのレイアウト

- [assets/](assets/) - サイトのテンプレートに使用する静的ファイル。
- [content/](content/) - ドキュメントのビルドに使用するソースファイル。主にMarkdownです。
- [content/\_code-samples/](content/_code-samples/) - ドキュメントに使用するか、ドキュメントで参照するコードサンプル。可能であれば、完全に機能するか実行可能なスクリプトです。
- [content/\_img-sources/](content/_img-sources/) - ドキュメントで使用する画像のソースファイル。`.uxf`ファイルはすべて、[Umlet](https://www.umlet.com/)で作成された図です。
- [content/\_snippets/](content/_snippets/) - 再利用可能なMarkdownテキストのまとまり。Dactylプリプロセッサーを使用して他のコンテンツファイルに組み込みます。
- [img/](img/) - ドキュメントのコンテンツに使用する画像。
- [tool/](tool/) - テンプレート、スタイルチェッカーのルール、その他スクリプト。
- [`dactyl-config.yml`](dactyl-config.yml) - メインの設定ファイル。すべてのドキュメントのメタデータが含まれます。規約についての詳細は、[設定の書式](#設定の書式)を参照してください。

## プルリクエストを成功させるための要件

プルリクエストがレビューまたはマージの対象になるためには、各プルリクエストが以下を満たしている必要があります。

- 継続的インティグレーションテストに合格している。
- レビューの準備ができるまでは[ドラフトのマークが付けられている](https://github.blog/2019-02-14-introducing-draft-pull-requests/)。
- このリポジトリーの[行動規範](CODE_OF_CONDUCT.md)に従っている。

## Dactylのセットアップ

このポータルは、[Dactyl](https://github.com/ripple/dactyl)を使用して構築されています。

Dactylには[Python 3](https://python.org/)が必要です。以下のようにして[pip](https://pip.pypa.io/en/stable/)でインストールしてください。

`sudo pip3 install dactyl`

## サイトのビルド

このリポジトリーでは、[**Dactyl**](https://github.com/ripple/dactyl)を使用して、すべてのドキュメントのHTML表示のバージョンをビルドできます。[Dactylのセットアップ](#dactylのセットアップ)が完了したら、プロジェクトのルートディレクトリーから以下のコマンドを使用してドキュメントをビルドできます。

```
dactyl_build
```

生成されたコンテンツが`out/`ディレクトリーに出力されます。これらのコンテンツは、ウェブブラウザーでファイルとして開くことも、ウェブサーバーで静的コンテンツとして提供することもできます。

同様に、ルートディレクトリーからリンクチェックやスタイルチェックを実行することもできます。

リンクチェックは、出力フォルダーを空にし、ドキュメントをビルドしてから実行する必要があります。

```
dactyl_link_checker
```

スタイルチェックは試験的なものです。

```
dactyl_style_checker
```

### 日本語サイトのビルド

ターゲットと出力先を指定してビルドしてください。

```
dactyl_build -t ja -o out/ja
```

日本語サイトの場合、生成されたコンテンツをウェブブラウザーでファイルとして開くことができません。ローカルHTTPサーバーやエディターの拡張機能(VSCodeであればLive Serverなど)を利用してください。

##### ローカルでHTTPサーバを利用する方法

1. `out`直下で次のコマンドを実施しサーバーを起動する

```
python -m http.server
```

2. ウェブブラウザーから`localhost`にアクセスする。
サーバー起動時にアサインされたポート番号を利用してください。

## 設定の書式

このリポジトリー内のテンプレートは`dactyl-config.yml`ファイルのメタデータを使用して、生成されたサイトをナビゲートする際のページ階層を生成します。ナビゲーションを正しく生成するには、ページの定義に適切なフィールドを含める必要があります。以下の例に、すべてのフィールドを指定したページを示します。
```
- md: concept-authorized-trust-lines.md
funnel: Docs
doc_type: Concepts
category: Payment System
subcategory: Accounts
targets:
- local
```

ナビゲーションには、フィールド`funnel`、`doc_type`、`category`、および`subcategory`をこの順序（広範から詳細へ）で使用します。各階層では、新しい値が最初に記載されるページが、その階層の親かランディングとなります。（例えば、「Accounts」サブカテゴリーの親には`subcategory: Accounts`フィールドがあり、子より前に記載されている必要があります。）ランディングページの場合は、下位階層フィールドを省きます。（例えば、「Concepts」doc_typeのランディングページには、`doc_type`フィールドは必要ですが、`category`フィールドは不要です。）

**警告:** いずれかのフィールドに入力ミスがあると、ページがナビゲーションに表示されないか、誤った場所に表示されるおそれがあります。

規約として、親ページには、親である階層と同じ名前が必要です。（例えば、`Payment System`カテゴリーのランディングページの名前は`Payment System`である必要があります。）`md`をソースとするファイルの名前は、そのファイルの最初の行のヘッダーによって自動的に決まります。

Markdownソースコンテンツのないページの場合は、`md`行を省き、代わりに以下のフィールドを記載します。

| フィールド | 内容 |
|:----------|:----------|
| `name` | 人間が読めるページ名（プレーンテキストのみ） |
| `html` | ページの出力ファイル名`.html`で終わり、ターゲット内で一意である必要があります。 |

## 翻訳

XRP Ledger開発者ポータルは主に英語で記載されているため、通常は英語版が最新かつ正確なバージョンです。しかし、XRP Ledgerのソフトウェアとコミュニティーの利用者を拡大するため、このリポジトリーには翻訳版のドキュメントも含まれています。他の言語を理解するコミュニティーのメンバーの皆様には、どうか開発者ポータルのコンテンツを母国語に翻訳していただけますようお願いいたします。

`dactyl-config.yml`には、使用可能な各言語の「ターゲット」項目が含まれます。（2019年11月18日現在、使用可能な言語は英語と日本語です。）この項目には、テンプレートファイルで使用する文字列の辞書が含まれています。例:

```yaml
- name: en
lang: en
display_name: XRP Ledger Dev Portal
# These github_ fields are used by the template's "Edit on GitHub" link.
# Override them with --vars to change which fork/branch to edit.
github_forkurl: https://github.com/XRPLF/xrpl-dev-portal
github_branch: master
strings:
blog: "Blog"
search: "Search site with Google..."
bc_home: "Home"
# ...
```

サポート対象の各言語のプロパティーをいくつか定義する最上位の`languages`リストもあります。各言語のショートコードは、[IETF BCP47](https://tools.ietf.org/html/bcp47)に沿ったものである必要があります。例えば、英語は「en」、スペイン語は「es」、日本語は「ja」、簡体字中国語は「zh-CN」、繁体字中国語（台湾で使用）は「zh-TW」になります。`display_name`フィールドでは、言語名をその言語で記載して定義します。`prefix`フィールドでは、その言語版のサイトへのハイパーリンクに使用されるプレフィックスを定義します。`languages`のサンプルの定義を以下に示します。

```yaml
languages:
- code: en
display_name:English
prefix: "/"
- code: ja
display_name:日本語
prefix: "/ja/"
```
同じ`dactyl-config.yml`ファイルに、XRP Ledger開発者ポータルの各コンテンツページの項目が記載されています。ページが翻訳されている場合は、翻訳ごとに別個の項目があり、その翻訳「ターゲット」にリンクされています。ページがまだ翻訳されていない場合は、すべての対象に英語版が使用されます。各ページで、HTMLファイル名（`html`フィールド）とナビゲーションフィールド（`funnel`、`doc_type`、`supercategory`、`category`、および`subcategory`。それぞれ、指定される場合）は、どの言語版のページでも同じである必要があります。翻訳版のページで内容の異なるフィールドは、以下のとおりです（いずれの場合においても、そのフィールドが項目で使用される場合に限ります）。

- **`name`** - ページのタイトル。通常は、Markdownソースファイルを使用しないランディングページや、[開発者用ツール](https://xrpl.org/dev-tools.html)などの独自のテンプレートを使用する特殊なページでのみ指定されます。通常、Markdownのファイルではこのフィールドが省かれます。Dactylはファイルの最初の行のヘッダーからタイトルを引き出すためです。
- **`md`** - ページのソースコンテンツとして使用するMarkdownファイル。規約として、翻訳したMarkdownソースファイルには英語版と同じファイル名を使用する必要があります。ただし、ファイルの拡張子は英語版のように`.md`のみでなく、`.{language code}.md`とする必要があります。例えば、日本語の翻訳ファイルは`.ja.md`で終わります。
- **`blurb`** - ページの要約。このテキストは主にcategoryランディングページで使用されます。

以下の例に、`server_info`メソッドページの英語の項目と日本語の項目を示します。

```yaml
- md: references/http-websocket-apis/public-api-methods/server-info-methods/server_info.md
html: server_info.html
funnel: Docs
doc_type: References
supercategory: rippled API
category: Public rippled Methods
subcategory: Server Info Methods
blurb: Retrieve status of the server in human-readable format.
targets:
- en
- md: references/http-websocket-apis/public-api-methods/server-info-methods/server_info.ja.md
html: server_info.html
funnel: Docs
doc_type: References
supercategory: rippled API
category: Public rippled Methods
subcategory: Server Info Methods
blurb: rippledサーバーについての各種情報を、人間が読めるフォーマットでサーバーに要求します。
targets:
- ja
```

翻訳されていないページの項目の例は以下のとおりです。

```yaml
- md: concepts/payment-system-basics/transaction-basics/source-and-destination-tags.md
html: source-and-destination-tags.html
funnel: Docs
doc_type: Concepts
category: Payment System Basics
subcategory: Transaction Basics
blurb: Use source and destination tags to indicate specific purposes for payments from and to multi-purpose addresses.
targets:
- en
- ja
```

### 最初にすべきこと

XRP Ledger開発者ポータルを任意の母国語に翻訳いただける場合は、XRP Ledgerの主要なプロパティーと機能について説明する[XRP Ledgerの概要ファイル](https://github.com/XRPLF/xrpl-dev-portal/blob/master/content/concepts/introduction/xrp-ledger-overview.md)から始めてください。

ファイル名は`xrp-ledger-overview.{language code}.md`で保存してください。`{language code}`は[IETF BCP47](https://tools.ietf.org/html/bcp47)の言語コードです。（例えば、スペイン語は「es」、日本語は「ja」、簡体字中国語は「zh-CN」、台湾で使用される繁体字中国語は「zh-TW」などです。）その後、このリポジトリーにファイルを追加する[プルリクエスト](https://help.github.com/en/github/collaborating-with-issues-and-pull-requests/about-pull-requests)を開きます。リポジトリーのメンテナーが、サイトに言語を追加するために必要なその他のセットアップについてお手伝いします。

Markdownコンテンツのファイルについては、以下の規則に従ってください。

- 改行には改行文字（`\n`）のみを使用します（Unix形式）。復帰改行文字（`\r`）は使用しないでください（Windows形式）。
- UTF-8エンコーディングを使用します。バイトオーダーマークは使用しないでください。
コントリビューションの情報には[「ドキュメントへの貢献」](https://xrpl.org/ja/contribute-documentation.html)をご覧ください。
Loading

0 comments on commit b51bcb4

Please sign in to comment.