--- a/src/interfaces/idocumentmodel.h
+++ b/src/interfaces/idocumentmodel.h
@@ -27,7 +27,22 @@
 {
 
 class IComponent;
+class IDocumentModelPrivate;
 
+/**
+ * \short A model to represent documents with components connected by connectors
+ *
+ * This is a base class for a table based model describing documents that contain
+ * some sort of components that are connected by connectors. Data is stored
+ * as \ref QVariantMap and must at least have a value for the "id" key and a unique
+ * id stored as it's value.
+ *
+ * The data is represented as an adjacent matrix with all components on the main diagonal
+ * and valid connectors at all other positions if there is a connection between the components
+ * corresponding to the rows and columns of the matrix. So, if there is a connection from
+ * the component at (i,i) to the component at (j,j) there will be valid data for
+ * a connector at (i,j).
+ */
 class KTLINTERFACES_EXPORT IDocumentModel : public QAbstractTableModel
 {
     Q_OBJECT
@@ -35,11 +50,96 @@
     IDocumentModel ( QObject* parent = 0 );
     ~IDocumentModel();
 
+    /**
+     * Add a valid component to the model. A component must at least have
+     * a field "id" which has to be unique. Adding a component with an id that
+     * already is in the model is not possible.
+     *
+     * @param component - A \ref QVariantMap containing all data for the component
+     * @return true if the component was added to the model
+     */
+    virtual void addComponent ( const QVariantMap& component );
+    /**
+     * Get a \ref QVariantMap containing all components mapped from id
+     * to a \ref QVariantMap containing all the data for the component.
+     *
+     * @return all components
+     */
+    virtual QVariantMap components() const;
+    /**
+     * Get a \ref QVariantMap containing all the data for the component specified
+     * by the given key.
+     *
+     * @param key - the id of the component
+     * @return a \ref QVariantMap containing the data
+     */
+    virtual QVariantMap component( const QString &key ) const;
+    /**
+    * Add a valid connector to the model. A connector must at least have
+    * a field "id" which has to be unique. Adding a connector with an id that
+    * already is in the model is not possible.
+    *
+    * @param component - A \ref QVariantMap containing all data for the component
+    * @return true if the component was added to the model
+    */
+    virtual void addConnector ( const QVariantMap& connector );
+    /**
+    * Get a \ref QVariantMap containing all connectors mapped from id
+    * to a \ref QVariantMap containing all the data for the connector.
+    *
+    * @return all connectors
+    */
+    virtual QVariantMap connectors() const;
+    /**
+    * Get a \ref QVariantMap containing all the data for the connector specified
+    * by the given key.
+    *
+    * @param key - the id of the connector
+    * @return a \ref QVariantMap containing the data
+    */
+    virtual QVariantMap connector( const QString &key ) const;
+
+    /**
+     * Get the data at a given field in the matrix.
+     *
+     * @param index - the \ref QModelIndex representing the field in the matrix
+     * @param role - the role of the data
+     * @return the data at the given index
+     */
+    virtual QVariant data ( const QModelIndex& index, int role = Qt::DisplayRole ) const;
+    /**
+     * Get the number of columns of the adjacent matrix. This equals the number of rows and
+     * the number of components.
+     *
+     * @return the number of columns of the matrix
+     */
+    int columnCount ( const QModelIndex& parent = QModelIndex() ) const;
+    /**
+    * Get the number of rows of the adjacent matrix. This equals the number of columns and
+    * the number of components.
+    *
+    * @return the number of rows of the matrix
+    */
+    int rowCount ( const QModelIndex& parent = QModelIndex() ) const;
+    /**
+     * Set data for a given field in the matrix.
+     *
+     * @param index - the \ref QModelIndex referencing the field of the matrix
+     * @param value - the value of the field as \ref QVariant
+     * @param role - the role which is responsible for setting the data
+     * @return true, if the data was set successful
+     */
+     virtual bool setData ( const QModelIndex& index, const QVariant& value, int role = Qt::EditRole );
+
 public slots:
     virtual void updateData( const QString &name, const QVariantMap &data );
 
 signals:
-    void dataUpdated( const QString &name, const QVariantMap &data );
+    void dataUpdated( const QString &name, const QVariantList &data );
+
+private:
+    IDocumentModelPrivate* d;
+
 };
 
 }