anchor.diff:  image:https://img.shields.io/github/license/sarl/sarl.svg?style=flat-square[link=https://opensource.org/licenses/Apache-2.0]
   image:https://cla-assistant.io/readme/badge/sarl/sarl[link=https://cla-assistant.io/sarl/sarl]
   
  +toc::[]
   
  -= License
  +== 2. Requirements
   
  -    Copyright 2014-2016 the original authors or authors.
  +* Java Development Toolkit (JDK) 1.8 or higher.
   
  -    Licensed under the Apache License, Version 2.0 (the "License");
  -    you may not use this file except in compliance with the License.
  -    You may obtain a copy of the License at
  +== 3. Using SARL
   
  -       http://www.apache.org/licenses/LICENSE-2.0
  +=== 3.1. Recommendations
   
  -    Unless required by applicable law or agreed to in writing, software
  -    distributed under the License is distributed on an "AS IS" BASIS,
  -    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  -    See the License for the specific language governing permissions and
  -    limitations under the License.
  +For making your experience with SARL the best, we recommend you:
   
  +* *to enable the assertions at development time (with the `-ea` command line option).*
  +
  +=== 3.2. Use the stable version with Maven
  +
  +The lastest stable version of SARL is available on link:http://search.maven.org/[Maven Central].
  +Consequently, you could directly include the SARL module into the Maven dependencies of your project:
  +
  +```xml
  +	...
  +	<dependency>
  +	  <groupId>io.sarl.maven</groupId>
  +	  <artifactId>io.sarl.maven.sdk</artifactId>
  +	  <version>0.3.1</version>
  +	</dependency>
  +	...
  +```
  +
  +Please, replace Version `0.3.1` in the previous snipset by the number of the version you want to use.
  +
  +=== 3.3. Use of the development version with Maven
  +
  +New features, enhancements and bug fixes are available in the SNAPSHOT (development) version of SARL.
  +For using this version, you must add the Maven Repository Server of SARL in your pom file:
  +
  +```xml
  +	...
  +	<dependencies>
  +	  <dependency>
  +	    <groupId>io.sarl.maven</groupId>
  +	    <artifactId>io.sarl.maven.sdk</artifactId>
  +	    <version>0.4-SNAPSHOT</version>
  +	  </dependency>
  +	<dependencies>
  +	...
  +	<repositories>
  +	  <repository>
  +	    <id>io.sarl-maven</id>
  +	    <name>SARL Snapshots</name>
  +	    <url>http://maven.sarl.io/</url>
  +	  </repository>
  +	</repositories>
  +	<pluginRepositories>
  +    	  <pluginRepository>
  +	    <id>io.sarl-maven</id>
  +	    <name>SARL Snapshots</name>
  +	    <url>http://maven.sarl.io/</url>
  +	    <snapshots>
  +	      <enabled>true</enabled>
  +	    </snapshots>
  +	  </pluginRepository>
  +	</pluginRepositories>
  +	...
  +```
  +
  +== 4. P2 Repository
  +
  +A P2 repository is set up and accesible at the address: `http://updates.sarl.io`.
  +
  +== 5. Issues
  +
  +Issues related to SARL are tracked on link:https://github.com/sarl/sarl/issues[GitHub]
  +You must use this issue tracker to report and follow your issues.
  +
  +== 6. Contributions
  +
  +Any contribution to the SARL is welcome.
  +
  +=== 6.1. Installing the Development Environment
  +
  +For setting up the development environment, you should follow the steps:
  +
  +CAUTION: Coming soon.
  +
  +=== 6.2. Obtaining the SARL Source Code
  +
  +For obtaining the code of SARL, you must clone it from the Git:
  +```bash
  +git clone https://github.com/sarl/sarl
  +```
  +
  +CAUTION: Due to an issue in the Eclipse Checkstyle plugin, it is mandatory to install the `build-tools` module in the your `.m2` repository prior to the first launch of the Eclipse IDE: `mvn clean install -Dcheckstyle.skip=true`
  +
  +=== 6.3. Compiling the SARL Source Code
  +
  +Maven is the standard tool for compiling SARL. It is recommended to launch the Maven compilation process on the command at least before submitting a pull request. The command line is:
  +```bash
  +mvn clean install
  +```
  +
  +=== 6.4. Sending the Contribution
  +
  +For sending your contribution to the SARL master repositoty, you must request a pull (PR) to the link:https://github.com/sarl/sarl/[GitHub repository].
  +
  +For being merged, your must ensure the following points:
  +
  +* Your PR must be compilable with Maven.
  +* Your PR must pass the compilation process successfully, including the code compilation, unit tests, and code style checking. This process is supported by Travis-CI for linux and OSX platforms, and AppVeyor for Windows platforms.
  +* You must sign the link:./licences/CLA.md[Contributor License Agreement] on GitHub. It is supported by link:https://cla-assistant.io/sarl/sarl[cla-assistant].
  +* Your PR should be reviewed by one or more of the main contributors for ensure it is following the development rules and philosophy related to SARL.
  +
  +The page of your PR on Github is displaying the status of your PR.
  +If one point is failing, please follows the steps:
  +
  +* Go on the Travis-CI or AppVeyor console for obtaining the cause of the failure.
  +* Fix the code of your PR on your local copy.
  +* Commit on your local repository, compile, and test until you have fixed the issue.
  +* Push the changes on the same PR with `git push -f`, i.e. the same Git repository as the one used for the PR. *Do not create a new PR for the fix.*
  +* The GitHub platform will relaunch the CI process automatically.
  +
  +== 7. Authors
  +
  +* link:http://www.multiagent.fr/People:Galland_stephane[Stéphane GALLAND], founder, original and active author.
  +* link:http://www.multiagent.fr/People:Gaud_nicolas[Nicolas GAUD], founder, original and active author.
  +* Jeremie JOST, documentation contributor.
  +* link:http://gitia.org/members/sebastian-rodriguez[Sebastian RODRIGUEZ], founder, original and active author.
  +
  +== 8. License of SARL
  +
  +SARL is distributed under the link:./LICENSE[Apache v2 license], and is copyrigthed to the original authors and the other authors, as expressed in the link:./NOTICE[NOTICE].
  +
  +== 9. Success Stories
  +
  +The following projects have sucessfully used SARL:
  +
  +* link:https://github.com/gallandarakhne.org/jaak[Jaak Simulation Library]
  +
  
positive.code: = SARL Agent Programming Language
  
  image:http://www.sarl.io/images/SARL-logo.svg[]
  
  SARL is a general-purpose agent-oriented language.
  
  SARL aims at providing the fundamental abstractions for dealing with concurrency, distribution, interaction, decentralization, reactivity, autonomy and dynamic reconfiguration. 
  These high-level features are now considered as the major requirements for an easy and practical implementation of modern complex software applications. 
  
negative.code: 
  image:https://img.shields.io/badge/requires-Java%208-red.svg?style=flat-square[link=https://www.java.com]
  image:https://travis-ci.org/sarl/sarl.svg?branch=master[link=https://travis-ci.org/sarl/sarl]
  image:https://ci.appveyor.com/api/projects/status/github/sarl/sarl?branch=master&svg=true[link=https://ci.appveyor.com/project/gallandarakhneorg/sarl]
  
  image:https://img.shields.io/badge/compliant-Maven-yellowgreen.svg?style=flat-square[link=http://maven.apache.com]
  image:https://img.shields.io/badge/compliant-Java-yellowgreen.svg?style=flat-square[link=https://www.java.com]
  