X-Git-Url: https://git.netwichtig.de/gitweb/?a=blobdiff_plain;f=README.md;h=7b1f35944df4e4d76181d236dc6b3640714ca85c;hb=de0ac87ec579fe23258f547521df9b3810d9bbb2;hp=050f0bb523cc8e42e69273745f7b170275b86f1a;hpb=5e7312aca321c8fee753f0734144923f1d8f55ad;p=user%2Fhenk%2Fcode%2Fshell%2Frif.git

diff --git a/README.md b/README.md
index 050f0bb..7b1f359 100644
--- a/README.md
+++ b/README.md
@@ -9,7 +9,7 @@ want to securely communicate with our friends. And chat with them. And
 know when they are online. Let's solve this problem once-and-for-all
 in a decentralised, sustainable and future proof way.
 
-## Here come's the real IPv6 friend
+## Here comes the real IPv6 friend
 
 Instead of using a single system or server, we use IPv6 to connect to
 our friends directly. Because each of our friends is reachable by IPv6
@@ -22,8 +22,8 @@ just connect to their computer!
 It's a bit geeky, but it works actually rather simple.
 To become a real IPv6 friend, you need to do the following things:
 
-- Generate a GPG key with a comment named RIF following the URL of
-  your computer
+- Generate a GPG key with a comment named **RIF** following the URL of
+  your computer (f.i. **RIF https://nico.ungleich.cloud**)
 - Ensure that the URL points to the IPv6 address of your computer
 - Setup a webserver on your computer
 - Export your key and all real IPv6 friend keys to your webserver as
@@ -157,19 +157,59 @@ exported keys! We import friends directly from the URL of a friend:
 curl -6 -s https://nico.ungleich.cloud/rifkeys | gpg --import
 ```
 
-You can also use
+You can also use the included rif-importfriends.sh.
+
+
+### Example: Updating your friends
+
+Now that you have imported the friends of your friends, they have
+automatically also become your friends!
+
+Obviously, you will want to check whether you even want to sign some
+of the friends (keys) that you downloaded, but clearly you want to
+show off with the biggest amount of friends (that's what is most
+important anyway, isn't it?).
+
+In any case, to update your friend list, simply repeat the command you
+ran above already in the beginning:
+
+```
+gpg -a --export RIF > /var/www/html/rifkeys
+```
+
+Or use the included `rif-exportfriends.sh`
+
+### Example: Importing friends of all friends and exporting them
+
+From time to time you might want to checkup on which friends gained
+new friends and add them to your friend list. This is as easy as
+iterating over all your friends and importing their friends into your
+friends list. And because you are a good friend, you might want to
+export all friends again.
+
+To make things easy, the included a script `rif-friendimportexport.sh`
+automates this process.
+
 
 ### Example: Sending a message to a friend
 
-Simply use your mail program for that.
-And obviously enable signing & encrypting the email.
+You can probably just use your mail program for that - and you might
+even be able to send it IPv6 only!
+
+## Finding friends
+
+As real IPv6 friends are decentralised, there is no central registry
+of friends. Just startup the webserver on your machine, export your
+key(s) and ping your friend.
 
+With every friend that is added to your network, the reach grows in
+the chain of all friends of every friend!
 
-## To be added
+So just start in your small cycle and forward your friend URL to your
+friends!
 
-- advanced usage -> ipv6 email
 
-### CLI ideas
+## About
 
-- **rif prepare**: check webserver, keyring, etc.
-- **rif online**: check who is online
+Real IPv6 friend is a project launched by Nico Schottelius on 2019-09-10.
+If you want to become my friend, my friend URL is https://nico.ungleich.cloud.