R&D: add indexes

docs/en/development/index.md

@@ -0,0 +1,4 @@
+---
+title: "Research and Development"
+---
+{% include 'devguide' %}

docs/en/proof-of-work/cryptonight.md

@@ -143,7 +143,7 @@ See the [rationale](https://github.com/monero-project/monero/pull/5126) and the
 
 ## Critique
 
-* CryptoNight hash is relatively expensive to verify. This poses a risk of DoS-ing nodes with incorrect proofs to process. See [strong asymmetry](../proof-of-work/what-is-pow.md#strong-asymmetry) requirement. 
+* CryptoNight hash is relatively expensive to verify. This poses a risk of DoS-ing nodes with incorrect proofs to process. See [strong asymmetry](../proof-of-work/index.md#strong-asymmetry) requirement.
 * The hash function was designed from scratch with limited peer review. While CryptoNight is composed of proven and peer-reviewed primitives, combining secure primitives doesn't necessarily result in a secure cryptosystem.
 * CryptoNight ultimately failed to prevent ASIC-s.
 * Complexity of CryptoNight kills competition in ASIC manufacturing.

docs/en/public-address/index.md

@@ -0,0 +1,11 @@
+---
+title: Address types
+---
+Monero addresses are what you publish/share to receive transactions.    
+Addresses can be generated offline, for free.
+
+There are a few **types of public addresses** in Monero:
+
+* [Standard address](./standard-address.md) - basic type of an address, often referred to as your "main" address
+* [Subaddress](./subaddress.md) - what you should be using by default.
+* [Integrated address](./integrated-address.md) - (deprecated) some exchanges, merchants, and other businesses accepting Monero may opt to use these instead of subaddresses

docs/en/public-address/main-address.md

@@ -1,3 +0,0 @@
----
-redirect: /public-address/standard-address/
----

docs/en/public-address/standard-address.md

@@ -1,35 +1,20 @@
 ---
 title: Standard Address
 ---
-# Address
+# Standard address
 
-Monero public address is what you publish to get paid.
-
-An address can be generated offline and for free. It boils down to generating a large random number representing your private spending key.
-
-Publishing your Monero address does __not__ endanger your privacy. That's because in Monero transactions go to stealth addresses which are decoupled from your public address.
-
-There are a few **types of public addresses** in Monero:
-
-* Standard address - basic type of an address, also referred to as raw address
-* Subaddress - what you should be using by default
-* Integrated address - relevant for exchanges, merchants, and other businesses accepting Monero in a fully automated way
-
-## Standard address
-
-Historically, raw address was the only available option. For that reason it is the most widely adopted and supported address type.
+Historically, the Main address was the only available option. For that reason it is the most widely supported address type.
 
 Its strength is simplicity. However, these days users should prefer receiving to subaddresses instead.
 
-Technically, raw address is also a basis for creating subaddresses and integrated addresses.
+Technically, main address is also a basis for creating subaddresses and integrated addresses.
 
-Raw address is **still useful for**:
+Main address is **still useful for**:
 
 * accepting block reward in a solo-mining scenario as other addresses are not supported
-* accepting from senders who batch payouts (like mining pools); in this scenario the sender is paying multiple parties using a single transaction; such transaction has multiple outputs; subaddresses do not work in this scenario
 * accepting from senders who use legacy wallets (can't send to subaddress)
 
-Monero raw address is composed of two public keys:
+Monero main address is composed of two public keys:
 
 * public spend key
 * public view key

docs/macros/includes/devguide

@@ -0,0 +1,15 @@
+- [Address Types](../public-address/index.md)
+- [Cryptography](../cryptography/index.md)
+- [Mnemonics](../mnemonics/index.md)
+- [Proof of Work](../proof-of-work/index.md)
+
+## External resources
+
+#### [Moneroexamples](https://github.com/moneroexamples)
+Rich list of examples and docs related to Monero development.
+
+#### [Monero Ecosystem project](https://github.com/monero-ecosystem)
+Community of Monero developers. Contains libraries and resources and guides of some Monero Workgroups, like the Localization Workgroup and the Outreach Workgroup.
+
+#### [Monero StackExchange](https://monero.stackexchange.com)
+One of the most complete resources for both users and developers.

mkdocs.yml

@@ -40,8 +40,14 @@ nav:
   - Node RPC: 'rpc-library/monerod-rpc.md'
   - Wallet RPC: 'rpc-library/wallet-rpc.md'
 - R&D:
+  - 'development/index.md'
+  - Address Types:
+    - 'public-address/index.md'
+    - Standard: 'public-address/standard-address.md'
+    - Subaddress: 'public-address/subaddress.md'
+    - Integrated: 'public-address/integrated-address.md'
   - Cryptography:
-    - Introduction: 'cryptography/introduction.md'
+    - 'cryptography/index.md'
     - Asymmetric: # Needs clarity
       - Introduction: 'cryptography/asymmetric/introduction.md'
       - Private keys: 'cryptography/asymmetric/private-key.md'
@@ -51,17 +57,13 @@ nav:
     - Base58: 'cryptography/base58.md'
     - Keccak-256: 'cryptography/keccak-256.md'
     - PRNG: 'cryptography/prng.md'
-  - Address Types:
-    - Standard: 'public-address/standard-address.md'
-    - Subaddress: 'public-address/subaddress.md'
-    - Integrated: 'public-address/integrated-address.md'
   - Mnemonics:
     - 'mnemonics/index.md'
     - Legacy: 'mnemonics/legacy.md'
     - MyMonero: 'mnemonics/mymonero.md'
     - Polyseed: 'mnemonics/polyseed.md'
   - Proof of Work: # This section needs improvement
-    - What is PoW?: 'proof-of-work/what-is-pow.md'
+    - 'proof-of-work/index.md'
     - PoW in Cryptocurrencies: 'proof-of-work/pow-in-cryptocurrencies.md'
     - CryptoNight: 'proof-of-work/cryptonight.md'
     - RandomX: 'proof-of-work/random-x.md'

po/cryptography-index.md.cfg

@@ -1,5 +1,5 @@
 [po4a_langs] es it pl fr ar ru de nl pt tr zh zh-TW nb
-[po4a_paths] ../weblate/en/cryptography/introduction.md.pot $lang:../weblate/$lang/cryptography/introduction.md.po
+[po4a_paths] ../weblate/en/cryptography/index.md.pot $lang:../weblate/$lang/cryptography/index.md.po
 
 [options] opt:"--keep=0"
 [options] opt:"--localized-charset=UTF-8"
@@ -10,4 +10,4 @@
 
 [po4a_alias:markdown] text opt:"--option markdown"
 
-[type: markdown] ../docs/en/cryptography/introduction.md $lang:../docs/$lang/cryptography/introduction.md
+[type: markdown] ../docs/en/cryptography/index.md $lang:../docs/$lang/cryptography/index.md

po/proof-of-work-index.md.cfg

@@ -1,5 +1,5 @@
 [po4a_langs] es it pl fr ar ru de nl pt tr zh zh-TW nb
-[po4a_paths] ../weblate/en/proof-of-work/what-is-pow.md.pot $lang:../weblate/$lang/proof-of-work/what-is-pow.md.po
+[po4a_paths] ../weblate/en/proof-of-work/index.md.pot $lang:../weblate/$lang/proof-of-work/index.md.po
 
 [options] opt:"--keep=0"
 [options] opt:"--localized-charset=UTF-8"
@@ -10,4 +10,4 @@
 
 [po4a_alias:markdown] text opt:"--option markdown"
 
-[type: markdown] ../docs/en/proof-of-work/what-is-pow.md $lang:../docs/$lang/proof-of-work/what-is-pow.md
+[type: markdown] ../docs/en/proof-of-work/index.md $lang:../docs/$lang/proof-of-work/index.md