Small improvements to docs/topics/db/models.txt
This commit is contained in:
parent
4b0f8d23c9
commit
695bc0d191
|
@ -4,9 +4,9 @@ Models
|
||||||
|
|
||||||
.. module:: django.db.models
|
.. module:: django.db.models
|
||||||
|
|
||||||
A model is the single, definitive source of data about your data. It contains
|
A model is the single, definitive source of information about your data. It
|
||||||
the essential fields and behaviors of the data you're storing. Generally, each
|
contains the essential fields and behaviors of the data you're storing.
|
||||||
model maps to a single database table.
|
Generally, each model maps to a single database table.
|
||||||
|
|
||||||
The basics:
|
The basics:
|
||||||
|
|
||||||
|
@ -48,7 +48,7 @@ Some technical notes:
|
||||||
|
|
||||||
* The name of the table, ``myapp_person``, is automatically derived from
|
* The name of the table, ``myapp_person``, is automatically derived from
|
||||||
some model metadata but can be overridden. See :ref:`table-names` for more
|
some model metadata but can be overridden. See :ref:`table-names` for more
|
||||||
details..
|
details.
|
||||||
|
|
||||||
* An ``id`` field is added automatically, but this behavior can be
|
* An ``id`` field is added automatically, but this behavior can be
|
||||||
overridden. See :ref:`automatic-primary-key-fields`.
|
overridden. See :ref:`automatic-primary-key-fields`.
|
||||||
|
@ -113,7 +113,7 @@ determine a few things:
|
||||||
|
|
||||||
* The database column type (e.g. ``INTEGER``, ``VARCHAR``).
|
* The database column type (e.g. ``INTEGER``, ``VARCHAR``).
|
||||||
|
|
||||||
* The default :doc:`widget </ref/forms/widgets>` to use when rendering a form
|
* The default HTML :doc:`widget </ref/forms/widgets>` to use when rendering a form
|
||||||
field (e.g. ``<input type="text">``, ``<select>``).
|
field (e.g. ``<input type="text">``, ``<select>``).
|
||||||
|
|
||||||
* The minimal validation requirements, used in Django's admin and in
|
* The minimal validation requirements, used in Django's admin and in
|
||||||
|
@ -237,7 +237,7 @@ sees you've explicitly set :attr:`Field.primary_key`, it won't add the automatic
|
||||||
``id`` column.
|
``id`` column.
|
||||||
|
|
||||||
Each model requires exactly one field to have :attr:`primary_key=True
|
Each model requires exactly one field to have :attr:`primary_key=True
|
||||||
<Field.primary_key>`.
|
<Field.primary_key>` (either explicitly declared or automatically added).
|
||||||
|
|
||||||
.. _verbose-field-names:
|
.. _verbose-field-names:
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue