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 the O’Reilly learning platform.
O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.
