Merge pull request #309 from voice1/master

Updated common-parameters.md

docs/fields/common-parameters.md

@@ -102,6 +102,32 @@ Sample usage:
 !!!info
     `server_default` is passed straight to sqlalchemy table definition so you can read more in [server default][server default] sqlalchemy documentation
 
+## name
+
+`name`: `str` = `None` -> defaults to None
+
+Allows you to specify a column name alias to be used. 
+
+Useful for existing database structures that use a reserved keyword, or if you would like to use database name that is different from `ormar` field name. 
+
+Take for example the snippet below. 
+
+`from`, being a reserved word in python, will prevent you from creating a model with that column name. 
+
+Changing the model name to `from_` and adding the parameter `name='from'` will cause ormar to use `from` for the database column name. 
+
+```python
+ #... rest of Model cut for brevity
+ from_: str = ormar.String(max_length=15, name='from')
+```
+
+Similarly, you can change the foreign key column names in database, while keeping the desired relation name in ormar:
+
+```python
+ # ... rest of Model cut for brevity
+album: Optional[Album] = ormar.ForeignKey(Album, name="album_id")
+```
+
 ## index
 
 `index`: `bool` = `False` -> by default False,