Guidelines for Composing a Field Description

  • Use a statement that accurately identifies the field and clearly states its purpose.

  • Write a clear and succinct statement.

  • Refrain from restating or rephrasing the field name.

  • Avoid using technical jargon, acronyms, or abbreviations.

  • Do not include implementation-specific information.

  • Do not make this description dependent upon the description of another field.

  • Do not use examples.

Get Database Design for Mere Mortals™: A Hands-On Guide to Relational Database Design, Second Edition now with O’Reilly online learning.

O’Reilly members experience live online training, plus books, videos, and digital content from 200+ publishers.