References restructuring. Fixes #1022

content/references/client-libraries.md

@@ -0,0 +1,19 @@
+---
+html: client-libraries.html
+parent: references.html
+blurb: Use these libraries to access the XRP Ledger from your programming language of choice.
+---
+# Client Libraries
+
+These client libraries simplify some of the common work of accessing and processing XRP Ledger data, and present it in a form that matches with the native conventions of their respective programming languages.
+
+For other programming languages, you can access the XRP Ledger through the [HTTP APIs](rippled-api.html).
+
+| Language | Library Name | Get Started | API Reference | Source Code |
+|----------|--------------|-------------|---------------|-------------|
+| **Python**   | `xrpl-py`      | [Get Started](get-started-using-python.html) | [API Reference](https://xrpl-py.readthedocs.io/) | [Repo](https://github.com/XRPLF/xrpl-py) |
+| **JavaScript** / **TypeScript** | `ripple-lib` | [Get Started](get-started-with-rippleapi-for-javascript.html) |  [API Reference](rippleapi-reference.html) | [Repo](https://github.com/ripple/ripple-lib) |
+| **C++**      | `rippled` Signing Library | [Get Started](https://github.com/ripple/rippled/tree/develop/Builds/linux#signing-library) |  | (Part of [`rippled`](https://github.com/ripple/rippled/)) |
+| **Java** | `xrpl4j` | [README](https://github.com/XRPLF/xrpl4j#readme) | [API Reference](https://github.com/XRPLF/xrpl4j/tree/main/xrpl4j-integration-tests)  | [Repo](https://github.com/XRPLF/xrpl4j) |
+
+**Tip:** To add a client library not listed here, please [suggest changes to this page]({{target.github_forkurl}}/edit/{{target.github_branch}}/content/{{currentpage.md}})!

content/references/protocol-reference/base58-encodings.ja.md

@@ -1,6 +1,6 @@
 ---
 html: base58-encodings.html
-parent: api-conventions.html
+parent: protocol-reference.html
 blurb: 暗号鍵と関連データをbase58形式で表すフォーマットです。
 ---
 # base58エンコード

content/references/protocol-reference/base58-encodings.md

@@ -1,6 +1,6 @@
 ---
 html: base58-encodings.html
-parent: api-conventions.html
+parent: protocol-reference.html
 blurb: Formats for representing cryptographic keys and related data in base58 format.
 ---
 # base58 Encodings

content/references/protocol-reference/basic-data-types.ja.md

@@ -1,6 +1,6 @@
 ---
 html: basic-data-types.html
-parent: api-conventions.html
+parent: protocol-reference.html
 blurb: さまざまなタイプのオブジェクトがそれぞれ異なる方法で一意に識別されます。
 ---
 # 基本的なデータ型

content/references/protocol-reference/basic-data-types.md

@@ -1,6 +1,6 @@
 ---
 html: basic-data-types.html
-parent: api-conventions.html
+parent: protocol-reference.html
 blurb: Format and meaning of fundamental data types like addresses, ledger index, and currency codes.
 ---
 # Basic Data Types

content/references/protocol-reference/currency-formats.ja.md

@@ -1,6 +1,6 @@
 ---
 html: currency-formats.html
-parent: api-conventions.html
+parent: protocol-reference.html
 blurb: 通貨番号の精度と範囲、カスタム通貨コードのフォーマットです。
 ---
 # 通貨フォーマット

content/references/protocol-reference/currency-formats.md

@@ -1,6 +1,6 @@
 ---
 html: currency-formats.html
-parent: api-conventions.html
+parent: protocol-reference.html
 blurb: Precision and range for currency numbers, plus formats of custom currency codes.
 ---
 # Currency Formats

content/references/protocol-reference/ledger-data/ledger-data-formats.ja.md

@@ -1,6 +1,6 @@
 ---
 html: ledger-data-formats.html
-parent: rippled-api.html
+parent: protocol-reference.html
 blurb: XRP Ledgerの共有状態を構成する個別のデータオブジェクトについて説明します。
 ---
 # レジャーのデータ型

content/references/protocol-reference/ledger-data/ledger-data-formats.md

@@ -1,6 +1,6 @@
 ---
 html: ledger-data-formats.html
-parent: rippled-api.html
+parent: protocol-reference.html
 blurb: Learn about individual data objects that comprise the XRP Ledger's shared state.
 ---
 # Ledger Data Formats

content/references/protocol-reference/modifying-the-ledger.ja.md

@@ -1,6 +1,6 @@
 ---
 html: modifying-the-ledger.html
-parent: api-conventions.html
+parent: protocol-reference.html
 blurb: トランザクションだけがレジャーを変更できる理由とその方法です。
 ---
 # レジャーの変更

content/references/protocol-reference/modifying-the-ledger.md

@@ -0,0 +1,13 @@
+---
+html: modifying-the-ledger.html
+parent: protocol-reference.html
+blurb: Why and how only transactions can modify the ledger.
+---
+# Modifying the Ledger
+
+All changes to the XRP Ledger happen as the result of [transactions](transaction-formats.html), and all changes apply permanently _only_ if the transactions are approved by the [consensus process](consensus.html). No matter what interface you use to access the XRP Ledger, no API method ever change the contents of the XRP Ledger, except by submitting a transaction.
+
+<!--{# common link defs #}-->
+{% include '_snippets/rippled-api-links.md' %}
+{% include '_snippets/tx-type-links.md' %}
+{% include '_snippets/rippled_versions.md' %}

content/references/protocol-reference/serialization.ja.md

@@ -1,6 +1,6 @@
 ---
 html: serialization.html
-parent: api-conventions.html
+parent: protocol-reference.html
 blurb: XRP Ledgerトランザクションやその他のオブジェクトの場合のJSONフォーマットと正規バイナリーフォーマットとの変換です。
 ---
 # シリアル化フォーマット

content/references/protocol-reference/serialization.md

@@ -1,6 +1,6 @@
 ---
 html: serialization.html
-parent: api-conventions.html
+parent: protocol-reference.html
 blurb: Conversion between JSON and canonical binary format for XRP Ledger transactions and other objects.
 ---
 # Serialization Format

content/references/protocol-reference/transactions/transaction-formats.ja.md

@@ -1,6 +1,6 @@
 ---
 html: transaction-formats.html
-parent: rippled-api.html
+parent: protocol-reference.html
 blurb: トランザクションは、XRP Ledgerを変更する唯一の方法です。
 template: template-landing-children.html
 ---

content/references/protocol-reference/transactions/transaction-formats.md

@@ -1,10 +1,10 @@
 ---
 html: transaction-formats.html
-parent: rippled-api.html
+parent: protocol-reference.html
 blurb: Transactions are the only way to modify the XRP Ledger. Get details about their required format.
 template: template-landing-children.html
 ---
-# Transaction Formats
+# Transaction Reference
 
 A _Transaction_ is the only way to modify the XRP Ledger. Transactions are only final if signed, submitted, and accepted into a validated ledger version following the [consensus process](consensus.html). Some ledger rules also generate _[pseudo-transactions](pseudo-transaction-types.html)_, which aren't signed or submitted, but still must be accepted by consensus. Transactions that fail are also included in ledgers because they modify balances of XRP to pay for the anti-spam [transaction cost][].