<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0"
	xmlns:content="http://purl.org/rss/1.0/modules/content/"
	xmlns:wfw="http://wellformedweb.org/CommentAPI/"
	xmlns:dc="http://purl.org/dc/elements/1.1/"
	xmlns:atom="http://www.w3.org/2005/Atom"
	xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
	xmlns:slash="http://purl.org/rss/1.0/modules/slash/"
	>

<channel>
	<title>R. Grossman &#38; Associates &#187; System Documentation</title>
	<atom:link href="http://www.tech-answers.com/category/published-articles/system-documentation/feed/" rel="self" type="application/rss+xml" />
	<link>http://www.tech-answers.com</link>
	<description>Electronic Security Consultants</description>
	<lastBuildDate>Mon, 05 Apr 2010 18:37:57 +0000</lastBuildDate>
	
	<language>en</language>
	<sy:updatePeriod>hourly</sy:updatePeriod>
	<sy:updateFrequency>1</sy:updateFrequency>
			<item>
		<title>Documenting Your System: Is There Such a Thing As Too Much Information? &#8211; Security Sales &amp; Integration</title>
		<link>http://www.tech-answers.com/published-articles/documenting-your-system-is-there-such-a-thing-as-too-much-information-security-sales-integration/</link>
		<comments>http://www.tech-answers.com/published-articles/documenting-your-system-is-there-such-a-thing-as-too-much-information-security-sales-integration/#comments</comments>
		<pubDate>Mon, 01 Nov 2004 04:01:07 +0000</pubDate>
		<dc:creator>rdgrossman</dc:creator>
				<category><![CDATA[Needs Assesment]]></category>
		<category><![CDATA[Published Articles]]></category>
		<category><![CDATA[System Documentation]]></category>

		<guid isPermaLink="false">http://www.tech-answers.com/?p=305</guid>
		<description><![CDATA[November 2004 by Robert Grossman, When documenting a system installation, how much detail is appropriate? The fact is, documenting a system is handled differently by all parties involved and is driven primarily by what the end user requires, demands and is willing to pay for.]]></description>
			<content:encoded><![CDATA[<p>Presumably, a large system could be commissioned with a full set of installation &#8220;as-built documents.&#8221; These drawings and documentation can show the interconnection and location of all devices as they were installed. This includes signal flow, troubleshooting information, cable designations and other pertinent information. Such a document could provide a permanent record of the system that can be updated in the future to reflect changes and additions.</p>
<p>At this point, many owners of large systems may be shaking their heads with an emphatic &#8220;No,&#8221; and owners of smaller systems are wondering how much of this detail and documentation is appropriate for them. Sadly, there is little by way of standards in our industry concerning what documentation should be left behind.</p>
<p>The fact is, documenting a system is handled differently by all parties involved and is driven primarily by what the end user requires, demands and is willing to pay for.</p>
<h3>Everything Has a Price</h3>
<p>If I were looking for one key differentiator used to justify varying bid amounts, it would be in the sophistication and thoroughness of the system documentation included in the bid. A high-end integrator will invariably bid a drawing package with the system that includes signal flow, cable numbering and designations, floor plans with device locations and junction points, and other documents showing the extent and scope of the system installation, customization and programming.</p>
<p>A cost-effective bidder may forgo the expense of creating such a package, assuming they have such capabilities. The package that they present upon system completion is often limited to a cardboard box containing the system manuals, accessory kits and warning sheets advising you not to operate your equipment in the shower or out in the rain for fear of electrical shock.</p>
<p>Let&#8217;s assume that all other things &#8211; product and installation quality, competence and support &#8211; are equal. If the only differentiator in price were the project documentation, what level of detail is appropriate for you? Remember, the reason the well-documented system costs more is simply a function of the labor involved. It takes time and expertise to produce this material and someone will need to pay for it.</p>
<h3>Size Matters in Levels of Detail</h3>
<p>If we&#8217;re talking about a very small system or one with a fairly simple topology, not much documentation is needed. At a minimum, the owner should receive that previously mentioned cardboard box.</p>
<p>A simple line drawing should also be provided showing what went where, and any programming tweaks or customizations should be marked in the appropriate manual. A bill-of material that is reconciled to the system order will prove invaluable down the road when a record of what was installed is needed for repair, expansion or insurance. Finally, a record of serial numbers for all installed equipment is handy. Put all of this material in a file or three-ring binder and save it for that rainy day.</p>
<p>As systems grow larger and more complex, the documentation should ratchet up accordingly. Since its main purpose will be to aid in service or expansion, a good rule of thumb is that the documentation should be a timesaver down the road. Look at everything &#8211; system and documentation &#8211; as if you were a third party being brought in to review your installation for the first time.</p>
<p>Remember, integrators go out of business and your own support staff may retire or seek employment elsewhere someday. There&#8217;s nothing like an accurate written record to get you through such a transition if it&#8217;s in your future.</p>
<h3>Make Time for Third Party Review</h3>
<p>No matter how basic or complex the system documentation is, make sure every word is reviewed by someone other than the person who put it together.</p>
<p>As a consultant, part of the final sign-off on a project is a final review of all as-built drawings, and it is rare that we don&#8217;t find a small list of mistakes. These errors can be typos or simple mistakes and are easily chalked up to &#8220;human nature.&#8221; They are easy to fix as part of the review process. However, if they&#8217;re not fixed, transposed numbers aren&#8217;t going to jump out at you several years from now. Correcting mistakes in documentation at that point will need to be done the hard way: with ladders, tool belts and an open checkbook.</p>
<p>Robert Grossman has spent more than 15 years in the industry and is president of R. Grossman and Associates (www.tech-answers.com), a consulting group specializing in electronic security products and projects. He can be reached at (609) 926-9264 or <a href="mailto:rdgrossman@securitysales.com">rdgrossman@securitysales.com</a>.</p>
<h4>Security Sales &amp; Integration 1 November 2004</h4>
<p><a href="http://www.tech-answers.com/wp-content/uploads/2009/08/SSI-BridgingTheGap-11-2004.pdf" target="_blank">Download this article in PDF format</a></p>
]]></content:encoded>
			<wfw:commentRss>http://www.tech-answers.com/published-articles/documenting-your-system-is-there-such-a-thing-as-too-much-information-security-sales-integration/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
		<item>
		<title>Consultants &#8211; Time to End the Confusion, Security Sales &amp; Integration</title>
		<link>http://www.tech-answers.com/published-articles/consultants-time-to-end-the-confusion-security-sales-integration/</link>
		<comments>http://www.tech-answers.com/published-articles/consultants-time-to-end-the-confusion-security-sales-integration/#comments</comments>
		<pubDate>Mon, 01 Mar 2004 04:01:10 +0000</pubDate>
		<dc:creator>rdgrossman</dc:creator>
				<category><![CDATA[Bid Support]]></category>
		<category><![CDATA[Needs Assesment]]></category>
		<category><![CDATA[Planning and Budgeting]]></category>
		<category><![CDATA[Product Evaluation]]></category>
		<category><![CDATA[Project Management]]></category>
		<category><![CDATA[Published Articles]]></category>
		<category><![CDATA[System Design]]></category>
		<category><![CDATA[System Documentation]]></category>
		<category><![CDATA[Vendor Assessment]]></category>

		<guid isPermaLink="false">http://www.tech-answers.com/?p=298</guid>
		<description><![CDATA[March 2004 by Robert Grossman, Webster’s Dictionary defines a "consultant" as "a person who gives professional or expert advice." But, with that definition, isn’t just about everyone a consultant?]]></description>
			<content:encoded><![CDATA[<p>Webster&#8217;s Dictionary defines a &#8220;consultant&#8221; as &#8220;a person who gives professional or expert advice.&#8221; But, with that definition, isn&#8217;t just about everyone a consultant? In our industry, organizations are quick to give their representatives titles that convey competence and expertise, which can be confusing to the end user.</p>
<p>How does the end user know who&#8217;s competent? With a sales engineer or systems architect, the answer is simple: Engineers and architects are degreed positions, so look for the diploma. But with consultants, it&#8217;s not as black and white.</p>
<p>Let&#8217;s create our own definition. We&#8217;ll stick with Webster as closely as we can: A consultant is a person who gives unbiased professional or expert advice and is beholden only to the person who has hired him.</p>
<p>Still, the advice given by a consultant varies, so let&#8217;s explore an advisor&#8217;s duties and responsibilities.</p>
<h3>Consultants Help Make Decisions</h3>
<p>Many vendors will provide design, engineering, installation and project management services as part of a &#8220;turn-key&#8221; solution. If you&#8217;ve selected such a vendor and are confident it will meet your needs, you do not need a consultant.</p>
<p>If there are several vendors involved, comparing their bids is much like comparing apples to oranges. If you believe that you can evaluate their offerings and select the one that best suits your needs, you&#8217;re acting as the consultant yourself and don&#8217;t need to hire outside help.<br />
But there&#8217;s a difference between need and benefit: Many organizations find that there are tangible benefits, both financial and operational, in employing this outside expertise.</p>
<h3>Consultants Often Act as Specifiers</h3>
<p>A consultant is hired by end users to look at their specific concerns and apply the appropriate technology and operational procedures to accomplish their goals. The objective can be very specific or ethereal, but the end result is generally a specification that details how the problem will be solved. These specifications fall into two categories: functional and performance specifications.</p>
<p>A functional specification describes what a system will do. It is generic in nature and written to allow multiple vendors to apply their specific products. Often, it relies on the lowest common denominator to ensure wider participation between vendors, and may be accompanied by an approved vendor list.</p>
<p>A performance specification is more stringent and describes how the system will work. To accomplish this, a consultant generally has a spe¥cific system in mind, and while others may equal the performance, the criteria are much tighter. This type of specification selects a single vendor &#8220;or equal,&#8221; and is often the basis for a sole-source procurement agreement.</p>
<p>With either type, the consultant evaluates the options, discusses them with the client and &#8211; based on his opinion and expertise &#8211; designs a system around the customer&#8217;s needs or budget. Sometimes a manufacturer is favored because the consultant has had good experiences and often the installed equipment dictates the add-on products, but there should be no financial incentive for the consultant to choose a particular brand.</p>
<p>The consultant provides this specification in a format that may be sent to multiple vendors, ensuring a competitive bid process. While he helps evaluate the different proposed products to verify their suitability, he also explains the intangibles. Does the integrator have a history of success¥fully completing projects like the client&#8217;s? Will the manufacturer support the product for the life of the system? Does the product have a good track record?</p>
<p>&#8220;Theory cannot compensate for actual experience,&#8221; says Fred Zagurski, of Fred Zagurski Consultants. &#8220;Only a consultant from the &#8216;field&#8217; will know what corners the bidders will try to shortcut, and (he) address these issues in their specifications.&#8221;</p>
<p>The consultant also acts as a representative during the construction and commissioning process. He ensures the installed system is the one specified, and will work through the many changes and add-ons that are inevitable side effects of the construction process. Often, a consultant will save his client more than his fees by ensuring the project stays on schedule and within budget.</p>
<h3>Integrity, Experience Are Crucial</h3>
<p>It&#8217;s clear there is no substitute for integrity and experience. To ensure a consultant&#8217;s independence, look for someone who is doing it for a living, and is not just &#8220;between jobs.&#8221; Look for experience with the type of project you are considering. And make sure he has been around long enough to have the reputation, industry contacts and people skills needed to smooth over the rough spots, should it come to that. Remember, your choice in consultant is a lot like a headache remedy &#8211; neither does you any good unless it takes away the pain.</p>
<p>Robert Grossman has spent more than 15 years in the industry and is president of R. Grossman and Associates (www.tech-answers.com),<br />
a consulting group specializing in electronic security products and projects.<br />
He can be reached at (609) 926-9264 or <a href="mailto:rdgrossman@securitysales.com">rdgrossman@securitysales.com</a></p>
<h4>Security Sales &amp; Integration 1 March 2004</h4>
<p><a href="http://www.tech-answers.com/wp-content/uploads/2004/03/SSI-BridgingTheGap-03-2004.pdf" target='_blank'>Download this article in PDF format</a></p>
]]></content:encoded>
			<wfw:commentRss>http://www.tech-answers.com/published-articles/consultants-time-to-end-the-confusion-security-sales-integration/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
	</channel>
</rss>
