Comments in English

 package org.legrog.entities;
 
 /**
- * Énumération des actions possibles.
+ * Available actions are an enumeration
  */
 public enum ActionType {
     VALIDATE;

@@ -3,8 +3,8 @@ package org.legrog.entities;
 import javax.persistence.*;
 
 /**
- * Entité persistante repésentant un pays.
- * Simplement composée d'un identitiant et d'un libellé.
+ * Country persistence entity
+ * Id and name seem enough
  */
 @Entity
 public class Country {

@@ -4,7 +4,7 @@ import javax.persistence.Id;
 import javax.persistence.Lob;
 
 /**
- * Classe simplifiée du contenu éditeur servant à l'indexation de données du PublisherVersion valide avec l'identifiant Publisher correspondant
+ * Simplified class for indexing validated publisher: content from PublisherVersion with id from Publisher
  */
 public class IndexedPublisher {
     @Id
@@ -17,9 +17,9 @@ public class IndexedPublisher {
     private String publisherHistory;
 
     /**
-     * Extrait l'id du Publisher et le nom et l'historique du PublisherVersion validé pour construire l'IndexedPublisher
+     * Extracts data needed for indexing from Publisher and its validated PublisherVersion
      *
-     * @param publisher
+     * @param publisher Publisher we want to be indexed
      */
     public IndexedPublisher(Publisher publisher) {
         PublisherVersion publisherVersion = publisher.getValidatedVersion();

@@ -4,9 +4,10 @@ import javax.persistence.*;
 import java.util.Set;
 
 /**
- * Entité persistante correspondant à un éditeur.
- * Pointe vers la version valide si elle existe, ainsi que son validateur et la date de validation.
- * Pointe vers l'ensemble de ses versions.
+ * Persisted entity for a publisher
+ * Has versions of type PublisherVersion
+ * May have a validated PublisherVersion among those
+ * Has access to PublisherAction related to it
  */
 @Entity
 public class Publisher /* extends org.roliste.data.DbLinkableEntity */ {

@@ -4,7 +4,7 @@ import javax.persistence.*;
 import java.sql.Timestamp;
 
 /**
- * Classe des actions sur des (versions d') éditeurs.
+ * Pesisted entity for actions made on PublisherVersion
  */
 @Entity
 public class PublisherAction {
@@ -21,7 +21,7 @@ public class PublisherAction {
 
     private Timestamp publisherActionDatetime;
 
-    // Accès simplifié plutôt que de passer par publisherVersion
+    // Simplified access instead of going through PublisherVersion
     @ManyToOne
     private Publisher publisher;
 

@@ -5,22 +5,23 @@ import org.springframework.data.jpa.repository.JpaRepository;
 import java.util.List;
 
 /**
- * Interface d'accès aux PublisherAction.
+ * Interface for accessing PublisherAction
  */
 public interface PublisherActionRepository extends JpaRepository<PublisherAction, Integer> {
 
     /**
-     * Retourne la dernière action du type indiqué sur le Publisher indiqué.
+     * Returns last action of a type for a publisher
      *
-     * @param actionType
-     * @param publisher
+     * @param actionType ActionType requested
+     * @param publisher Publisher concerned by the action
      * @return PublisherAction
      */
     PublisherAction findFirstByActionTypeAndPublisherOrderByPublisherActionDatetimeDesc(ActionType actionType, Publisher publisher);
 
     /**
-     * Retourne l'ensemble des actions concernant la PublisherVersion indiquée
-     * @param publisherVersion
+     * Returns all actions for a PublisherVersion
+     *
+     * @param publisherVersion PublisherVersion concerned by the actions
      * @return List<PublisherAction>
      */
     List<PublisherAction> findByPublisherVersion(PublisherVersion publisherVersion);

 package org.legrog.entities;
 
 /**
- * Interface d'indexation/recherche des IndexedPublisher
+ * Indexing/Search interface for IndexedPublisher
  */
 public interface PublisherSearchRepository {
     /**
-     * Indexe la version simplifiée de Publisher, IndexedPublisher.
+     * Indexes an IndexedPublisher
      *
-     * @param indexedPublisher
+     * @param indexedPublisher IndexedPublisher to be indexed
      * @return IndexedPublisher
      */
     public IndexedPublisher save(IndexedPublisher indexedPublisher) throws IndexingException;

@@ -10,7 +10,7 @@ import javax.inject.Inject;
 import java.io.IOException;
 
 /**
- * Classe implémentant l'interface PublisherSearchRepository avec l'API SolrJ
+ * Implementation of PublisherSearchRepository using SolrJ
  */
 public class PublisherSearchRepositorySolrj implements PublisherSearchRepository {
     Logger logger = LoggerFactory.getLogger(getClass());

@@ -4,11 +4,9 @@ import javax.persistence.*;
 import java.sql.Timestamp;
 
 /**
- * Entité persistente représentant une version d'un éditeur.
- * Contient les données représentant un éditeur.
- * Adresse découpée en suivant http://schema.org/PostalAddress.
- * Pointe vers l'éditeur auquel elle correspond.
- * Pointe vers l'auteur de la version et contient la date et heure de celle-ci.
+ * Persisted entity for a publisher version
+ * Contains the data
+ * Postal Address is split according to http://schema.org/PostalAddress
  */
 @Entity
 public class PublisherVersion {