Ver Fonte

doc/misc/darkirc/darkirc: move network level privacy section before usage

skoupidi há 1 ano atrás
pai
commit
189c715134
1 ficheiros alterados com 29 adições e 15 exclusões
  1. 29 15
      doc/src/misc/darkirc/darkirc.md

+ 29 - 15
doc/src/misc/darkirc/darkirc.md

@@ -22,7 +22,7 @@ Nothing else exists like it.
 
 <u><b>Note</b></u>: `darkirc` follows IRC's [RFC2812](https://www.rfc-editor.org/rfc/rfc2812)
 
-## Installation
+## Building
 
 Follow the instructions in the [README](../../index.html#build) to ensure
 you have all the necessary dependencies. After that, in repo root folder:
@@ -34,6 +34,18 @@ you have all the necessary dependencies. After that, in repo root folder:
 % # sudo make install darkirc 
 ```
 
+## Installation
+
+It is adviced to use `darkirc` directly from the repo root folder.
+Install system wide only if you can make sure there would be no
+multiple darkirc versions installed:
+
+```shell
+% sudo make install darkirc
+```
+
+You have to reinstall `darkirc` on new versions manually.
+
 ## Installation (Android)
 
 This is for Android 64 bit (which is most phones).
@@ -75,6 +87,20 @@ additionally there is a mirror on telegram @darkfi_darkirc channel.
 You can also message @darkirc_bot with "sub" to avoid doxxing your username.
 Use "unsub" to unsubscribe.
 
+## Network-level privacy
+
+Nodes have knowledge of their peers, including the IP addresses of
+connected hosts. We suggest configuring your instance to use a different
+transport so it is not connected via clearnet.
+
+DarkFi supports the use of pluggable transports, including [Tor](../nodes/tor-guide.md#configure-network-settings)
+and Nym, to provide network-level privacy. As long as there are live seed
+nodes configured to support a Tor or Nym connection, users can connect to
+`darkirc` and benefit from the protections offered by these protocols.
+
+Other approaches include connecting via a cloud server or VPN. Research
+the risks involved in these methods before connecting.
+
 ## Usage (DarkFi Network)
 
 Upon compiling `darkirc` as described above, the preconfigured defaults
@@ -96,7 +122,8 @@ default in `~/.config/darkfi/` you can review and potentially edit. It
 might be useful if you want to add other channels you want to autojoin 
 (like `#philosophy` and `#memes`), or if you want to set a shared 
 secret for some channel in order for it to be encrypted between its 
-participants.
+participants. We strongly suggest to make sure you are using the
+desired network transport before proceeding.
 
 When done, you can run `darkirc` for the second time in order for it to
 connect to the network and start participating in the P2P protocol:
@@ -162,19 +189,6 @@ the changes to reflect, like so:
 /rehash
 ```
 
-## Network-level privacy
-
-Nodes have knowledge of their peers, including the IP addresses of 
-connected hosts.
-
-DarkFi supports the use of pluggable transports, including Tor and Nym, 
-to provide network-level privacy. As long as there are live seed nodes
-configured to support a Tor or Nym connection, users can connect to 
-`darkirc` and benefit from the protections offered by these protocols.
-
-Other approaches include connecting via a cloud server or VPN. Research 
-the risks involved in these methods before connecting.
-
 ## Usage (Local Deployment)
 
 These steps below are only for developers who wish to make a testing