Update README.md

Author: adamjohnwright

src/main/java/org/reactome/server/graph/aop/README.md

@@ -1,18 +1,18 @@
 <img src=https://cloud.githubusercontent.com/assets/6883670/22938783/bbef4474-f2d4-11e6-92a5-07c1a6964491.png width=220 height=100 />
 
-Aspect Oriented Programming with Spring
+Aspect-Oriented Programming with Spring
 ===
 
 :warning: Changes in this package have to be taken carefully, considering it is going to reflect in the whole application
 
 ### What is Aspect-Oriented Programming - AOP?
 
-Spring AOP framework is used to modularize cross-cutting concerns in aspects. Simply, t’s just an interceptor to intercept some processes, for example, when a method is execute, Spring AOP can hijack the executing method, and add extra functionality before or after the method execution. The most used feature is logging.
+Spring AOP framework is used to modularize cross-cutting concerns in aspects. Simply, it’s just an interceptor to intercept some processes, for example, when a method is executed, Spring AOP can hijack the executing method, and add extra functionality before or after the method execution. The most used feature is logging.
 However, in Reactome, we are taking benefit of this concept in order to implement our own Lazy-Loading mechanism. This functionality is also available in ORM frameworks, such as, Hibernate and to achieve this they are implementing AOP concepts. Sorting and Logging aspect are present as well.
 
-Complete information of Spring AOP you'll find [here](https://docs.spring.io/spring/docs/current/spring-framework-reference/html/aop.html).
+Complete information on Spring AOP you'll find [here](https://docs.spring.io/spring/docs/current/spring-framework-reference/html/aop.html).
 
-### What are the `@PointCut` in Reactome for LazyLoading ?
+### What are the `@PointCut` in Reactome for LazyLoading?
 
 ```java
 execution(public java.util.Collection<org.reactome.server.graph.domain.model.DatabaseObject+>+ org.reactome.server.graph.domain.model.*.get*(..))
@@ -24,7 +24,7 @@ execution(public org.reactome.server.graph.domain.model.DatabaseObject+ org.reac
 ```
 Intercepting ALL the getters in our Domain Model whose return type is `DatabaseObject` or `instance of`
 
-### How does it work ?
+### How does it work?
 
 Mainly, we are loading DEPTH{2} data from the graph without any relationship previously loaded, only identifiers. Once intercepted, the code checks whether the AOP is enabled and whether the object has been loaded previously. Substantially using Java Reflection, the code is capable to identify all the information regarding the method that has been intercepted, for instance, return type (`Collection` or `DatabaseObject`) and `@Relationship` which contains important information for querying against the Graph. Up to this point, the data have been retrieve and the code invokes the setter and proceed.
 
@@ -95,19 +95,19 @@ public LazyFetchAspect lazyFetchAspect() {
 </plugin>
 ```
 
-#### What is the flag `enableAOP` ?
+#### What is the flag `enableAOP`?
 
-The AOP is enabled by default, but in certain projects like [Content Service](https://github.com/reactome-pwp/content-service.git) where we respond a serialised JSON, the `@PointCut` will be invoked every where, every time, endless times. Thus, given the requirements of the `Content Service` it makes sense that we disable this feature. However, in the [Data Content](https://github.com/reactome/data-content) we kept it enabled.
+The AOP is enabled by default, but in certain projects like [Content Service](https://github.com/reactome/content-service.git) where we respond a serialised JSON, the `@PointCut` will be invoked everywhere, every time, endless times. Thus, given the `Content Service` requirements, it makes sense that we disable this feature. However, we kept it enabled in the [Data Content](https://github.com/reactome/data-content).
 
 
 =
 
-### SortingAspect ?
+### SortingAspect?
 
 Intercepting ALL the getters in our Domain Model whose return type is `Collection<? extends DatabaseObject>` and sorting the list based on the `displayName`.
 
 =
 
-### LoggingAspect ?
+### LoggingAspect?
 
-Logging everything at the service level. The package `service` is being intercepted in order to measure the execution time.
+Logging everything at the service level. The package `service` is being intercepted to measure the execution time.