diff --git a/manual/docs/en/schema-files.txt b/manual/docs/en/schema-files.txt
index f50983b5e..012e95fa3 100644
--- a/manual/docs/en/schema-files.txt
+++ b/manual/docs/en/schema-files.txt
@@ -6,17 +6,221 @@ Schema files support all the normal things you would write with manual php code.
++ Relationships
+When specifying relationships it is only necessary to specify the relationship on the end where the foreign key exists, although both ways are supported.
+
++++ One to One
+
+
+---
+User:
+ columns:
+ id:
+ type: integer(4)
+ primary: true
+ autoincrement: true
+ contact_id:
+ type: integer(4)
+ username:
+ type: string(255)
+ password:
+ type: stirng(255)
+ relations:
+ Contact:
+ foreignType: one
+Contact:
+ columns:
+ id:
+ type: integer(4)
+ primary: true
+ autoincrement: true
+ name:
+ type: string(255)
+
+
++++ One to Many
+
+
+---
+User:
+ columns:
+ id:
+ type: integer(4)
+ primary: true
+ autoincrement: true
+ contact_id:
+ type: integer(4)
+ username:
+ type: string(255)
+ password:
+ type: stirng(255)
+Phonenumber:
+ columns:
+ id:
+ type: integer(4)
+ primary: true
+ autoincrement: true
+ name:
+ type: string(255)
+ user_id:
+ type: integer(4)
+ relations:
+ User:
+ foreignAlias: Phonenumbers
+
+
++++ Many to Many
+
+
+User:
+ columns:
+ id:
+ type: integer(4)
+ autoincrement: true
+ primary: true
+ username:
+ type: string(255)
+ password:
+ type: string(255)
+ attributes:
+ export: all
+ validate: true
+Group:
+ tableName: groupp
+ columns:
+ id:
+ type: integer(4)
+ autoincrement: true
+ primary: true
+ name:
+ type: string(255)
+ relations:
+ Users:
+ foreignAlias: Groups
+ class: User
+ refClass: GroupUser
+GroupUser:
+ columns:
+ group_id:
+ type: integer(4)
+ primary: true
+ user_id:
+ type: integer(4)
+ primary: true
+
+
++ Connection Binding
+
+Doctrine::connection('mysql://jwage:pass@localhost/connection1', 'connection1');
+
+
+
+---
+User:
+ connection: connection1
+ columns:
+ id:
+ type: integer(4)
+ primary: true
+ autoincrement: true
+ contact_id:
+ type: integer(4)
+ username:
+ type: string(255)
+ password:
+ type: stirng(255)
+
+
++ Attributes
+
+---
+User:
+ connection: connection1
+ columns:
+ id:
+ type: integer(4)
+ primary: true
+ autoincrement: true
+ contact_id:
+ type: integer(4)
+ username:
+ type: string(255)
+ password:
+ type: stirng(255)
+ attributes:
+ export: none
+ validate: false
+
++ Templates
+
+---
+User:
+ connection: connection1
+ columns:
+ id:
+ type: integer(4)
+ primary: true
+ autoincrement: true
+ contact_id:
+ type: integer(4)
+ username:
+ type: string(255)
+ password:
+ type: stirng(255)
+ templates:
+ MyCustomTemplate
+ option1: value
+ option2: value
+
+
++ ActAs
+
+---
+User:
+ connection: connection1
+ columns:
+ id:
+ type: integer(4)
+ primary: true
+ autoincrement: true
+ contact_id:
+ type: integer(4)
+ username:
+ type: string(255)
+ password:
+ type: stirng(255)
+ actAs:
+ Sluggable:
+ fields: [username]
+
+
++ Options
+
+---
+User:
+ connection: connection1
+ columns:
+ id:
+ type: integer(4)
+ primary: true
+ autoincrement: true
+ contact_id:
+ type: integer(4)
+ username:
+ type: string(255)
+ password:
+ type: stirng(255)
+ options:
+ type: INNODB
+ collate: utf8_unicode_ci
+ charset: utf8
+
+
++ Indexes
Please see chapter [doc basic-schema-mapping :index :name] for more information about indexes and their options.