Time Standards

Naturally, the first question that needs to be answered is whether to use the 12- or 24-hour clock to represent time information. In the case of the 12-hour clock, a time in either the morning or afternoon is indicated hy the use of the common abbreviations AM or PM, usually following the time. Standards usually dictate that the granularity of time information should not exceed hours and minutes, except in technical documentation where more accuracy is required. A discrete piece of time...

Agenda Style

Finally, all meetings need an agenda. This is to communicate the goal of the meeting to the participants, and is usually set by the meeting organizer. It should probably not exceed one page, preferably one side only. The contents will be, at a minimum, the title, location, date and time of the meeting, participant list (anticipated), and a series of points detailing the topics of conversation. Each organization will probably have its own sets of agenda templates, depending on the meetings that...

Project Database Maintenance

Besides the actual deliverables that the project teams should be required to generate as a matter of course, a fair amount of information about the projects will be generated during their life cycle. There will be costing information, including staffing and equipment, all the information relating to team efficiency, and personal development of staff members during the life of the project, much of which is passed back to the Liaison Center from the various project and team managers. This...

IT Infrastructure

Usually, the target organization will have certain policies that dictate the distribution of IT equipment, from workstations to servers, networking equipment, and so forth. However, due to the quantity and nature of the information that will be accumulated, stored, and referenced, it is advisable to allocate a separate server for the Liaison Center, with sufficient storage capacity, backup procedure, and robustness. If electronic mail is used for communication within the organization, mailboxes...

Industry Standards

There are a number of standards used in the technical writing industry, ranging from simple word processor template sets that can be reused in corporate documentation guidelines, to complete document engineering standards that require substantial training to use effectively. They are all based on one simple principle the ability to effectively identify the problem domain (that which we want to document) and then break it down into pieces that can be logically grouped in order to create a...

Designing the Problem Area

Einlinienorganisation

One of the first diagrams to be created may not find its way into the formal specifications since it is designed to aid the understanding between client, developer, designers, and end users. From this general understanding, the formal specifications will be created, so it is an important, if informal, diagram. The best way to construct the diagram is in the guise of a brainstorming session, with all parties mentioned in the preceding section present or at least represented. The reason for this...

Selling the Liaison Center

Currently, times are hard in the software development industry. In such times, it can become increasingly difficult to sell something that has every appearance of being a cost center as opposed to part of the revenue machine that keeps the organization afloat. However, it is a cost saver without it, the software development process can be in danger of losing its way, and individual software engineers, designers, and programmers may not be working within an infrastructure that makes the best use...