From 3886db64bccad752a24e1f239f8830a584118b09 Mon Sep 17 00:00:00 2001 From: Diogo Cordeiro Date: Sun, 2 Jun 2019 18:09:38 +0100 Subject: [PATCH] [DOCUMENTATION] Update README.md --- .../{PLUGINS.txt => PLUGINS.md} | 12 +++--- README.md | 42 +++++++++---------- 2 files changed, 25 insertions(+), 29 deletions(-) rename DOCUMENTATION/SYSTEM_ADMINISTRATORS/{PLUGINS.txt => PLUGINS.md} (87%) diff --git a/DOCUMENTATION/SYSTEM_ADMINISTRATORS/PLUGINS.txt b/DOCUMENTATION/SYSTEM_ADMINISTRATORS/PLUGINS.md similarity index 87% rename from DOCUMENTATION/SYSTEM_ADMINISTRATORS/PLUGINS.txt rename to DOCUMENTATION/SYSTEM_ADMINISTRATORS/PLUGINS.md index 44d2ea2d44..007f2d4b95 100644 --- a/DOCUMENTATION/SYSTEM_ADMINISTRATORS/PLUGINS.txt +++ b/DOCUMENTATION/SYSTEM_ADMINISTRATORS/PLUGINS.md @@ -10,13 +10,13 @@ and has a choice of accepting or rejecting the events. In the simplest case, you can add a function to config.php and use the Event::addHandler() function to hook an event: -function AddMyWebsiteLink($action) -{ -$action->menuItem('http://mywebsite.net/', _('My web site'), _('Example web link')); -return true; -} + function AddMyWebsiteLink($action) + { + $action->menuItem('http://mywebsite.net/', _('My web site'), _('Example web link')); + return true; + } -Event::addHandler('EndPrimaryNav', 'AddMyWebsiteLink'); + Event::addHandler('EndPrimaryNav', 'AddMyWebsiteLink'); This adds a menu item to the end of the main navigation menu. You can see the list of existing events, and parameters that handlers must diff --git a/README.md b/README.md index f5f768be76..3266dbda30 100644 --- a/README.md +++ b/README.md @@ -1,26 +1,22 @@ # GNU social 1.3.x -2015 - -(c) Free Software Foundation, Inc +(c) 2010 Free Software Foundation, Inc This is the README file for GNU social, the free software social networking platform. It includes general information about the software and the project. -Some other files to review: +The file INSTALL.md has useful instructions on how to +install this software. -- INSTALL: instructions on how to install the software. -- UPGRADE: upgrading from earlier versions -- CONFIGURE: configuration options in gruesome detail. -- PLUGINS.txt: how to install and configure plugins. -- EVENTS.txt: events supported by the plugin system -- COPYING: full text of the software license +System administrators may find the DOCUMENTATION/SYSTEM_ADMINISTRATORS +directory useful, namely: -Information on using GNU social can be found in -the "doc" subdirectory or in the "help" section -on-line, or you can catch us on IRC in #social on -the freenode network. +- upgrade_from: upgrading from different software +- CONFIGURE.md: configuration options in gruesome detail. +- PLUGINS.md: how to install and configure plugins. + +Developers may find the DOCUMENTATION/DEVELOPERS directory useful. ## About @@ -39,8 +35,8 @@ mobile phones, instant messenger programs (using XMPP), and specially-designed desktop clients that support the Twitter API. -GNU social supports an open standard called -OStatus that lets users in +GNU social supports open standards (such as OStatus +) that lets users in different networks follow each other. It enables a distributed social network spread all across the Web. @@ -97,6 +93,8 @@ liberal terms, but those terms may differ in detail from the AGPL's particulars. See each package's license file in the extlib directory for additional terms. +Refer to COPYING.md for full text of the software license.. + ### Troubleshooting The primary output for GNU social is syslog, @@ -117,14 +115,14 @@ to install the development version of GNU social. To get it, use the git version control tool like so: - git clone git@git.gnu.io:gnu/gnu-social.git + git clone git@notabug.org:diogo/gnu-social.git In the current phase of development it is probably recommended to use git as a means to stay up to date with the source code. You can choose between these branches: -- master "stable", more updates, usually working well -- nightly "unstable", most updates, not always working +- master "stable", usually working well +- nightly "unstable", most updates, not always working as expected To keep it up-to-date, use 'git pull'. Watch for conflicts! @@ -135,9 +133,7 @@ There are several ways to get more information about GNU social. * The #social IRC channel on freenode.net . * The unofficial XMPP room linked to IRC on * The GNU social website -* Following us on GNU social -- * GNU social has a bug tracker for any defects you may find, or ideas for - making things better. -* Patches are welcome, preferrably to our repository on git.gnu.io. - + making things better. +* Patches are welcome, preferrably to our repository on notabug.org.