From 47d8ea67148bb8ebab333c78e90cd0baf2b028d0 Mon Sep 17 00:00:00 2001 From: kaeff Date: Tue, 1 Sep 2015 13:42:29 +0200 Subject: Update README with docs from website & instructions on local DB - Copy intro chapter from homepage - Advise new users to not test with admin party locally - Ignore couchdb.admin.yml so it's consistent with the regular couchdb.yml --- README.md | 41 ++++++++++++++++++++++++++++++++--------- 1 file changed, 32 insertions(+), 9 deletions(-) (limited to 'README.md') diff --git a/README.md b/README.md index f2d69ca..7e016c6 100644 --- a/README.md +++ b/README.md @@ -1,22 +1,31 @@ LEAP Web --------------------- -"LEAP Web" is the web-based component of the LEAP Platform, providing -the following services: +The LEAP Web App provides the following functions: -* REST API for user registration. -* Admin interface to manage users. -* Client certificate distribution and renewal. -* User support help tickets. -* Billing +* User registration and management +* Help tickets +* Client certificate renewal +* Webfinger access to user’s public keys +* Email aliases and forwarding +* Localized and Customizable documentation -This web application is written in Ruby on Rails 3, using CouchDB as the -backend data store. +Written in: Ruby, Rails. + +The Web App communicates with: + +* CouchDB is used for all data storage. +* Web browsers of users accessing the user interface in order to edit their settings or fill out help tickets. Additionally, admins may delete users. +* LEAP Clients access the web app’s REST API in order to register new users, authenticate existing ones, and renew client certificates. +* tokens are stored upon successful authentication to allow the client to authenticate against other services + +LEAP Web is provisioned and run as part of the overall [LEAP platform](https://leap.se/en/docs/platform). Original code specific to this web application is licensed under the GNU Affero General Public License (version 3.0 or higher). See http://www.gnu.org/licenses/agpl-3.0.html for more information. + Documentation --------------------------- @@ -26,6 +35,15 @@ For more information, see these files in the ``doc`` directory: * DEVELOP -- for developer notes. * CUSTOM -- how to customize. +External docs: + +* [Overview of LEAP architecture](https://leap.se/en/docs/design/overview) - Bird's eye view of how all the pieces fit together. +* [Contributing](https://leap.se/en/docs/get-involved) - Contributing to LEAP software development. + * Contributing to LEAP software development + * How to issue a pull request + * Overview of the main code repositories + * Ideas for discrete, unclaimed development projects that would greatly benefit the LEAP ecosystem. + Known problems --------------------------- @@ -70,6 +88,11 @@ Typically, you run ``bundle`` as a normal user and it will ask you for a sudo password when it is time to install the required gems. If you don't have sudo, run ``bundle`` as root. +### Installation for development purposes + +Please see `doc/DEVELOP.md` for further required steps when installing +leap_web for development purposes. + Configuration ---------------------------- -- cgit v1.2.3