Comments update

EditorialModel/__init__.py

@@ -0,0 +1,2 @@
+## @package EditorialModel
+# @brief Group all objects usefull for editorial model management

EditorialModel/backend/__init__.py

@@ -0,0 +1,2 @@
+## @package EditorialModel.backend
+# @brief Backend that allows the EM to handle different data sources

EditorialModel/backend/json_backend.py

@@ -1,7 +1,10 @@
 # -*- coding: utf-8 -*-
 
-## @file json_backend.py
-# Load representation of an EditorialModel from a json file
+## @package EditorialModel.backend.json_backend
+# @brief Handle json files
+# 
+# Allows an editorial model to be loaded/saved in
+# json format
 
 import json
 import datetime
@@ -67,4 +70,4 @@ class EmBackendJson(object):
     # @return bool
     # @todo à implémenter
     def save(self):
-        return True
+        return True

EditorialModel/components.py

@@ -1,7 +1,9 @@
 # -*- coding: utf-8 -*-
 
-## @file components.py
-# Defines the EditorialModel::components::EmComponent class and the EditorialModel::components::ComponentNotExistError exception class
+## @package EditorialModel.components
+# @brief Base objects for all EditorialModel components
+# 
+# Defines the EditorialModel::components::EmComponent class
 
 import datetime
 import logging

EditorialModel/migrationhandler/__init__.py

@@ -0,0 +1,6 @@
+## @package EditorialModel.migrationhandler
+# @brief Tell to an editorial model wether or not a wanted modification is possible
+#
+# The migration handler provide an API for the EditorialModel to ask wether or not a model modification
+# is possible/allowed.
+#

EditorialModel/migrationhandler/dummy.py

@@ -1,5 +1,10 @@
 # -*- coding: utf-8 -*-
 
+## @package EditorialModel.migrationhandler.dummy
+# @brief A dummy migration handler
+#
+# According to it every modifications are possible
+#
 
 ## Manage Model changes
 class DummyMigrationHandler(object):