ArtsAutosBooksBusinessEducationEntertainmentFamilyFashionFoodGamesGenderHealthHolidaysHomeHubPagesPersonal FinancePetsPoliticsReligionSportsTechnologyTravel

The Role of Documentation and People in System Development

Updated on June 20, 2014

This paper will cover two aspects of system development; the roles of documentation and people. I will define what documentation is and present the idea that UML is an important and heavily used method of documentation. I will also present the idea that documentation will be important during the transition phase. The rolethat people play in system development is presented.It is shown that there are a large number of rolls that someone can play.

Documentation in System Development

A document is anything that has a purpose of presenting information to any person who might use the system under development (Ambler, 2002). Based on this definition provided by Ambler it can be assumed that documentation is the process of gathering and putting together anything that is used as information by any person regarding the system under development.

UML is the most often used method for documenting everything from application structure to data and business processes (UML Resource Page, 2009). Most aspects of the System development process has an UML document type that can be used.According to Ambler there are three classifications of UML documents; behavior diagrams, interaction diagrams, and structure diagrams (Ambler, 2009). Behavior diagrams are diagrams that show behavior of a business process or a system (Ambler, 2009). Interaction diagrams, as their name implies, documents interactions between objects in the system (Ambler, 2009). Structure diagrams documents the different elements of a system.

During every system development there will be a time when one system will be transitioned into the newly developed system. “A “transition” or “cut-over” plan, including any required data conversion, will also be required to ensure a smooth transition to the new system without interrupting services. The development of appropriate documentation, such as manuals for operations and maintenance, are required for successful transition” (US House of Representatives, 1999, ¶ 12). The United States House of Representatives here make a very good point regarding documentation. Proper documentation makes transitions smother when moving from one system to another or when upgrades to an existing system are made.

People in System Development

As I began to research the different roles that people can play in the development of a system I discovered that my personal experience has only found skimmed the surface on the possible roles that can be played.In my career I have had the opportunity to be a Project Manager,Functional Analyst, Technical Resource, Super User, and a Trainer. Indiana University lists at five different resources used just in data object naming (Indiana University, 2009).

Looking at the roles that people play a large number of the information roles can easily be identified. Some of these roles are functional analyst, solution architect, development lead, developer, quality assurance, deployment, trainer, and project manager (Bogue, 2006). As I mentioned before, Ihave had the opportunity to participate in some of these roles, and it has been my observation that the more roles someone has been in the more theyseem see the entire big picture of a system development project. An example of the organization of these roles is shown in Figure 1.

The rolls that have been previously presented are roles that fit into the information technology side of system development. Outside of the information technology realm the business user’s will also play a role. Business users become very handy in the discovery and in testing of system development.

Figure 1.

Figure 1. Roles Within the Development Community, (2006) Source
Figure 1. Roles Within the Development Community, (2006) Source

As one can see documentation is a very important piece of system development. One of the most common techniques, UML, has many different document types useful in different stages of the development process. There is an importance to having materials available for the transition from one system to another. People play an important role as well in the development of a system. Information technology provides many of the roles needed to develop a system successfully.

References used in this article.

Ambler, S. W. (2002). Agile/Lean Documentation: Strategies for Agile Software Development. Retrieved November 22, 2009 from

Ambler, S. W. (2009). Introduction to the Diagrams of UML 2.0. Retrieved November 22, 2009 from

Bogue, R. (2006). Roles Within the Development Community. Retrieved November 22, 2009 from

Indiana University. (2009). Roles and Responsibilities in the Systems Development Methodology. Retrieved November 22, 2009 from

UML Resource Page. (2009). Unified Modeling Language. Retrieved November 22, 2009 from

U.S. House of Representatives. (1999). Systems Development Life-Cycle Policy. Retrieved November 22, 2009 from


    0 of 8192 characters used
    Post Comment

    No comments yet.


    This website uses cookies

    As a user in the EEA, your approval is needed on a few things. To provide a better website experience, uses cookies (and other similar technologies) and may collect, process, and share personal data. Please choose which areas of our service you consent to our doing so.

    For more information on managing or withdrawing consents and how we handle data, visit our Privacy Policy at:

    Show Details
    HubPages Device IDThis is used to identify particular browsers or devices when the access the service, and is used for security reasons.
    LoginThis is necessary to sign in to the HubPages Service.
    Google RecaptchaThis is used to prevent bots and spam. (Privacy Policy)
    AkismetThis is used to detect comment spam. (Privacy Policy)
    HubPages Google AnalyticsThis is used to provide data on traffic to our website, all personally identifyable data is anonymized. (Privacy Policy)
    HubPages Traffic PixelThis is used to collect data on traffic to articles and other pages on our site. Unless you are signed in to a HubPages account, all personally identifiable information is anonymized.
    Amazon Web ServicesThis is a cloud services platform that we used to host our service. (Privacy Policy)
    CloudflareThis is a cloud CDN service that we use to efficiently deliver files required for our service to operate such as javascript, cascading style sheets, images, and videos. (Privacy Policy)
    Google Hosted LibrariesJavascript software libraries such as jQuery are loaded at endpoints on the or domains, for performance and efficiency reasons. (Privacy Policy)
    Google Custom SearchThis is feature allows you to search the site. (Privacy Policy)
    Google MapsSome articles have Google Maps embedded in them. (Privacy Policy)
    Google ChartsThis is used to display charts and graphs on articles and the author center. (Privacy Policy)
    Google AdSense Host APIThis service allows you to sign up for or associate a Google AdSense account with HubPages, so that you can earn money from ads on your articles. No data is shared unless you engage with this feature. (Privacy Policy)
    Google YouTubeSome articles have YouTube videos embedded in them. (Privacy Policy)
    VimeoSome articles have Vimeo videos embedded in them. (Privacy Policy)
    PaypalThis is used for a registered author who enrolls in the HubPages Earnings program and requests to be paid via PayPal. No data is shared with Paypal unless you engage with this feature. (Privacy Policy)
    Facebook LoginYou can use this to streamline signing up for, or signing in to your Hubpages account. No data is shared with Facebook unless you engage with this feature. (Privacy Policy)
    MavenThis supports the Maven widget and search functionality. (Privacy Policy)
    Google AdSenseThis is an ad network. (Privacy Policy)
    Google DoubleClickGoogle provides ad serving technology and runs an ad network. (Privacy Policy)
    Index ExchangeThis is an ad network. (Privacy Policy)
    SovrnThis is an ad network. (Privacy Policy)
    Facebook AdsThis is an ad network. (Privacy Policy)
    Amazon Unified Ad MarketplaceThis is an ad network. (Privacy Policy)
    AppNexusThis is an ad network. (Privacy Policy)
    OpenxThis is an ad network. (Privacy Policy)
    Rubicon ProjectThis is an ad network. (Privacy Policy)
    TripleLiftThis is an ad network. (Privacy Policy)
    Say MediaWe partner with Say Media to deliver ad campaigns on our sites. (Privacy Policy)
    Remarketing PixelsWe may use remarketing pixels from advertising networks such as Google AdWords, Bing Ads, and Facebook in order to advertise the HubPages Service to people that have visited our sites.
    Conversion Tracking PixelsWe may use conversion tracking pixels from advertising networks such as Google AdWords, Bing Ads, and Facebook in order to identify when an advertisement has successfully resulted in the desired action, such as signing up for the HubPages Service or publishing an article on the HubPages Service.
    Author Google AnalyticsThis is used to provide traffic data and reports to the authors of articles on the HubPages Service. (Privacy Policy)
    ComscoreComScore is a media measurement and analytics company providing marketing data and analytics to enterprises, media and advertising agencies, and publishers. Non-consent will result in ComScore only processing obfuscated personal data. (Privacy Policy)
    Amazon Tracking PixelSome articles display amazon products as part of the Amazon Affiliate program, this pixel provides traffic statistics for those products (Privacy Policy)