diff --git a/docs/guide/defining-documents.rst b/docs/guide/defining-documents.rst index d276b041..f59f856e 100644 --- a/docs/guide/defining-documents.rst +++ b/docs/guide/defining-documents.rst @@ -214,9 +214,9 @@ document class as the first argument:: Dictionary Fields ----------------- -Often, an embedded document may be used instead of a dictionary -- generally -this is not recommended as dictionaries don't support validation or custom field -types. However, sometimes you will not know the structure of what you want to +Often, an embedded document may be used instead of a dictionary – generally +embedded documents are recommended as dictionaries don’t support validation +or custom field types. However, sometimes you will not know the structure of what you want to store; in this situation a :class:`~mongoengine.fields.DictField` is appropriate:: class SurveyResponse(Document):