Skip repetitive navigation links.
United States Department of AgricultureFarm Services AgencySystem Development Life Cycle (SDLC)
Go to SDLC Home Go to SDLC Home Go to About SDLC Go to News Go to Help Go to Contact Us
Search FSA
Go To Advanced Search
Go To Search Tips
FSA Enterprise Architecture
Go to EA Overview
Go to Enterprise Architecture Program
Go to Enterprise Architecture
Go to FSA Infrastructure
FSA SDLC
Go to SDLC Overview
Go to Background
Go to Development Process
Go to Quick Start Guide
Go to FSA Quality Assurance & Control Process
Go to Project Management Process
Go to Configuration and Change Management
Mainframe & System 36 SDLC
Browse by Subject
Go to Developer Tools Overview
Go to Architectural Decisions/Waivers
Go to FSA Assets and Shared Services
Go to Approved Software
Go to Templates and Documents
Go to Information Bulletins & Memos
Browse by Subject
Go to Learning Overview
Go to Training Schedule
Development Process

Standardize the Vocabulary

 

 
To remain consistent and reduce misunderstandings, a common vocabulary is established for all business terms, technical terms, abbreviations/acronyms, and actors that are relevant to the project. This common vocabulary should be used in all descriptions of the system.

 
It is important to use existing terminology of the business when possible. The Application Development Glossary defines terms and acronyms common to the FSA. Any terms defined in the FSA Glossary do not need to be included in project level glossaries.

 
To identify common terms in the domain, consider terms used in the requirements, as well as the development team's general knowledge of the system to be built. Focus on terms describing the following concepts:

 
  • Business concepts used in the organization's daily work or in the system's expected operating environment. In many cases, a list of concepts of this kind already exists.
  • Real-world entities or events for which the system needs to be aware. These objects occur naturally, and include such things as: farm, land, tract, crop, state, county, etc.

 
Each term in the common vocabulary should typically be described as a noun, with a definition. Terms should be in the singular form (i.e., "order" and "task", not "orders" and "tasks"). All interested stakeholders should agree on definitions for the terms.

 
Refer to the Glossary template for more details.


Last Modified: 12/07/10 8:45:34 AM


SDLC Home | FSA Home | USDA.gov | Common Questions | Site Map | Policies and Links
FOIA | Accessibility Statement | Privacy Policy | Nondiscrimination Statement | Information Quality | USA.gov | White House