Home Library Translate
A A A
Share »
Follow us on Facebook Follow us on Twitter Follow us on LinkedIn
Connect »

Blog: Business Communications

Menu

  • This Blog's Home
  • Guest Writer Submissions
  • Policies
  • To Subscribe to a Blog
  • About
  • Feedback

Documenting The Network

By Theresa Pojuner on May 18, 2015

How does the Technical Writer or Communicator document a network of machines that communicate with one another? Documenting even a small company’s network on how its machines communicate or transmit information or data can be a challenging task. This includes learning and describing how each piece of equipment operates.

The Technical Writer has to know how each machine functions and know its varied components. The writer also has to understand how the machines communicate among themselves and to humans. The machines can consist of any of the following – backup systems, servers, laptops, peripheral’s like printers, ip addresses that identify each machine, protocols that are a set of rules for communicating, its wiring or connectors, its properties, ports, etc.

 The following is a list of suggestions to follow.

  • First, create a chart of all the equipment within the company and note the location of each. Label everything.
  • Second, get a description of each piece of equipment and its functionality.
  • Third, get a description of the software involved; set up, usage, accessibility, and maintenance.

Example:

If a piece of equipment is connected to another device via a cable,

  • Note its description, location, functionality, and associated software.
  • Create drawings, mappings, wireframes, etc. of all the equipment that are associated and located in one area and label each item. In any organization, do this for every piece of equipment and group them into categories.

Creating categories and sub categories.

Break it down.

Example:

If a laptop is connected to a printer via a USB cable, or if the laptop is connected wirelessly, create a category labelled printers. Then create sub categories of hard-wired and wireless printers.

When creating the documentation:

Use diagrams

  • Mappings to show functionality within the company.
  • Diagrams to show the design and the internal components of each piece of equipment.
  • Wireframes for showing the skeleton of the connections for communication.
  • Graphics to show the movement or the process for transmitting information or data.

Create detailed documentation, including

  • Creating detailed user manuals and reference guides.
  • Listing the owners and those authorized to use the system.
  • Describing the system features, menus, what to do and what not to do, and possible error messages.
  • Describing the hardware, ports, and mechanics of the system.
  • Writing about the protocols of the system.
  • Describing how the information is transmitted, and how the machines communicate with one another.

Pages and pages of diagrams and documentation can be created, but it can be simplified. Break it down by categories, such as regions, or procedures and processes. Create a hierarchy from the top down. At the top, state the goal. Then, as you go down, break it down by systems, then applications, then processes, then hardware, etc. till you get to the bottom where the intricacies are denoted and explained.

If you have had experience documenting a network of systems, and wish to add to this topic, please leave a comment. Thank you.

« Previous Next »

Search Our Site

Meet This Blog’s Host

Gail Zack Anderson, President of Applause, Inc., has nearly 20 years experience in training and coaching. She provides individual presentation coaching, and leads effective presentation workshops and effective trainer workshops. [Read more ...]


Theresa Pojuner is a Documentation Specialist with over 20 years of writing experience and is skilled in many areas of documentation, for example, Style Guides, Training Manuals and Test Cases, wth a specialty n Technical Writing and Procedures. [Read more ...]

Recent Blog Posts
Alternate Recent Posts Widget

  • Becoming A Technical Writer-Communicator Review
  • Creating A Knowledge Community
  • Tips for Handling Technical Writer Stress
  • Likeminded Communication
  • A Technical Writer Is Different From Other Writers
  • Involve and Engage Your Audience 20 Ways
  • Tips On Documenting Processes
  • Communicating Technical Writing Review
  • Communicating Via Visual Designs
  • Special Tips for Laptop Presentations

Related Library Topics

  • Body Language
  • Netiquette

Categories of Posts

  • Basics and Overviews
  • Body Language
  • Communicating Change
  • Communication Best Practices
  • Feedback (Sharing)
  • Humor in speaking
  • images
  • Listening
  • Netiquette
  • Presenting
  • slide shows
  • Speaking Skills
  • Team Presentations
  • technical writing
  • Telephone Skills
  • Uncategorized
  • Visual Aids
  • Voice and Vocal Habits
  • Writing

Library's Blogs

  • Boards of Directors
  • Building a Business
  • Business Communications
  • Business Ethics, Culture and Performance
  • Business Planning
  • Career Management
  • Coaching and Action Learning
  • Consulting and Organizational Development
  • Crisis Management
  • Customer Service
  • Facilitation
  • Free Management Library Blogs
  • Fundraising for Nonprofits
  • Human Resources
  • Leadership
  • Marketing and Social Media
  • Nonprofit Capacity Building
  • Project Management
  • Quality Management
  • Social Enterprise
  • Spirituality
  • Strategic Planning
  • Supervision
  • Team Building and Performance
  • Training and Development
About Feedback Legal Privacy Policy Contact Us
Free Management Library, © Copyright Authenticity Consulting, LLC ®; All rights reserved.
  • Graphics by Wylde Hare LLC
  • Website maintained by Caitlin Cahill

By continuing to use this site, you agree to our Privacy Policy.X