INSTALL.txt

@@ -12,7 +12,7 @@ This will clone the entire repository in a directory called addon.  They can now
 * Install Manually *
 ********************
 
-1. Download the archive (AddonName.tgz) containing the addon you want to install.
+1. Download the archive (Download ZIP button) containing the addons.
 2. Unzip the contents of the archive to your harddrive.
 3. Upload the extracted directory and all it's contents to /path/to/friendica/addon.  You will need to create the addon directory if this is the first addon you have installed.
 4. Activate the addon in the plugins section of your admin panel.

README.md

@@ -0,0 +1,34 @@
+Addons for Friendica
+====================
+
+This repository is a collection of plugins for the [Friendica Social Communications Server](https://github.com/friendica/friendica).
+You can add these plugins to the /addon directory of your Friendica installation
+do extend the functionality of your node.
+
+After uploading the addons to your server, you need to activate the desired addons
+in the Admin panel. Addons not activated have no effect on your node.
+
+You can find more addons in the [Friendica Addon listing](https://addons.friendo.ca)
+in cases the addon developers have choosen not to include them here.
+
+Connectors
+----------
+
+Among these plugins there are also the [connectors](https://github.com/friendica/friendica/blob/master/doc/Connectors.md) for various other networks
+(e.g. Twitter, pump.io, Google+) that are needed for communication when the
+protocoll is not supported by Friendica core (DFRN, OStatus and Diaspora).
+
+For communication with contacts in networks supporting those (e.g. GNU social,
+Diaspora and red#matrix) you just need to access the page configuration in the
+Admin panel and enable them. For networks where communication is only possible
+the API access to a remote account, you need to activate the fitting connectors.
+
+Development
+-----------
+
+The addon interface of Friendica is very flexible and powerful, so if you are
+missing functionality, your chances are high it may be added with an addon.
+See the [documentation](https://github.com/friendica/friendica/blob/master/doc/Plugins.md) for more informations on the plugin development.
+
+Addons can be translated like any other part of Friendica. Translations for the
+addons included in this repository are done at the [Transifex project](https://www.transifex.com/projects/p/friendica/) for Friendica.