• MarTech Today
  • Sections
    • Ads
    • Marketing
    • Content
    • Sales
    • Analytics
    • Management
    • Resources
    • More
    • Home
  • MarTech Today
  • Ads
  • Marketing
  • Content
  • Sales
  • Analytics
  • Mgmt
  • Resources
  • More
  • Events
  • SUBSCRIBE

MarTech Today

MarTech Today
  • Ads
  • Marketing
  • Content
  • Sales
  • Analytics
  • Management
  • Resources
  • More
  • Events
  • Newsletters
  • Home
Martech: Management

Martech stack documentation is vital, here are some tips to do it right

By maintaining documentation, important details are shared more easily and less likely to fall through the cracks.

Steve Petersen on August 25, 2020 at 8:00 am
  • More

It’s important to maintain documentation about a martech stack. Stacks typically have dozens of components used by dozens of people, and keeping track of everything is tough. By maintaining documentation, important details are shared more easily and less likely to fall through the cracks.  

There are many ways to manage documentation, and the correct decisions are dictated by individual circumstances. It isn’t easy and is an ongoing process. Here are some things to consider.

Program and platform

In many cases, documentation likely begins with spreadsheets. This is a good place to start, but they have limitations.  

Fortunately, there are services designed specifically for martech stack documentation like CabinetM, Airstack, and Martechbase. There are related and more general tech stack solutions like StackShare and Zylo, which are also useful. These solutions offer features like stack visualization, product directories for comparison, data exports for external use, skill mapping, and information importing and exporting.

These solutions are great for providing information to vendors, but it may make sense to maintain a related set of documentation for internal purposes. If an organization has a wiki, that’s a great candidate for hosting the documentation since most employees should have access by default. Thus, this a good place for people from other departments (IT, legal, and procurement) to have access to stack information. Further, in this venue, documentation can include more confidential information (like budgets, strategic planning, and internal assessments) that wouldn’t be appropriate to share with vendors or other external parties.

What to document

Regardless of the venue (internal or external), there’s some important high-level information to track.   Two very important pieces of information in this category include the overall purpose of the stack component as well as who are the main people associated with it (executive, sponsor, technical lead, and power users). This information alone is very valuable as it will help address why a company uses something and who to ask for more details.

Another thing valuable for external and internal audiences is information regarding system integrations.  Vendors in particular will likely need access to at least high-level information so that they can better align their efforts with where information from their system will flow to others. However, not every vendor needs such information, and an internal system is likely a better place for more detailed information that vendors don’t need access to.

Contract information is another very crucial information category. Important factors are contract dates, total expenses, billing cycles, and which budget funds the contract. Further, information can include – if applicable – the number and types of user licenses, features contracted, and any contractual limitations.

An important question for documentation to answer is: How is the stack component performing in regard to the organization’s needs and goals? If it is not, what’s needed to address this deficiency (user training, contract adjustment, integration work, etc.)? In many cases, the best people to provide the component’s goals and overall performance are the sponsor, technical lead, and power users. Usually a simple classification of “succeeding” or “not succeeding” is sufficient. Documenting component needs and recommended actions near the goal performance information can logically allow others to quickly find what actions are needed, if any.

Tracking stack overlaps is also helpful. It is certainly possible that a stack has components that have duplicate functionality. Sometimes there’s a reason for this. For instance, site uptime monitors, web governance platforms (for accessibility checks, broken links, etc.), and tag auditors all check sites to ensure that they’re running as they scan them. However, they all focus on different core competencies; thus, a tag auditor won’t cut it in regard to minute-by-minute uptime checks nor accessibility standards compliance. In this scenario, it makes sense to have components with functionality overlaps, and documentation can help keep track of why that is the case. Further, documenting overlaps can spark questions about if the overlap is necessary, efficient, or needed.

Perhaps one of the most robust types of information to document is freeform notes. These can capture anything else specific to an individual component. It is useful to indicate the date of each note as well as using full names of people and explicit identification of external parties so that a broader audience can get a clearer picture of decisions and circumstances.

Conclusion

Documenting stack information is very important for martech management. However, it’s not easy and requires constant attention. Considering the factors above should help determine what one should do given their unique circumstances.

Here’s a template to get you started:

Download the PDF version here.

Opinions expressed in this article are those of the guest author and not necessarily MarTech Today. Staff authors are listed here.



About The Author

Steve Petersen
Steve Petersen is a marketing technology manager at Western Governors University in Salt Lake City, Utah. He started on WGU's marketing website team where he helped create and implement several initiatives including site redesign and maintenance, multivariate testing, user testing and mobile app development. Prior to WGU, he worked as a strategist at the Washington, DC digital agency The Brick Factory where he worked closely with trade associations, non-profits, major brands, and advocacy campaigns. Petersen holds a Master of Information Management from the University of Maryland and a Bachelor of Arts in International Relations from Brigham Young University. He's also a Certified ScrumMaster.

Related Topics

Channel: Martech: ManagementMartech Column

Subscribe to receive daily martech news and expert insights. See terms.


We're listening.

Have something to say about this article? Share it with us on Facebook and Twitter.

Get the daily newsletter digital marketers rely on.
See terms.

ATTEND OUR EVENTS

MarTech 2021: March 16-17

MarTech 2021: Sept. 14-15

MarTech 2020: Watch On-Demand

×

Attend MarTech - Click Here


Learn More About Our MarTech Events

White Papers

  • The Media-First Approach Why visual media must be a primary consideration for e-commerce businesses
  • Visual Experiences That Connect: A look at the power of UGC and the tech needed to support it
  • Become an Experience-Led Business with an Agile CX Tech Stack
  • Transformational CX: Video-Powered Experiences Meet Consumers’ Demands
  • What Customer Experience Means in 2021
See More Whitepapers

Webinars

  • The AI Revolution Is Coming to Every Stage of Your Buyer’s Journey
  • The Fundamentals of Link Building for E-Commerce & Affiliate Sites in 2021
  • Your Customer is Calling: Make the Most of Your Marketing Spend with Call Tracking
See More Webinars

Research Reports

  • Local Marketing Solutions for Multi-Location Businesses
  • Enterprise Digital Asset Management Platforms
  • Identity Resolution Platforms
  • Customer Data Platforms
  • B2B Marketing Automation Platforms
  • Call Analytics Platforms
See More Research

Register For MarTech - Free

Receive daily martech news and analysis.

Channels

  • Advertising
  • Marketing
  • Content
  • Social
  • Commerce
  • Sales
  • Analytics
  • Management
  • Home

Our Events

  • MarTech
  • SMX

Resources

  • White Papers
  • Research
  • Webinars

About

  • About Us
  • Contact
  • Privacy
  • Marketing Opportunities
  • Staff

Follow Us

  • Facebook
  • Twitter
  • LinkedIn
  • Newsletters
  • RSS

© 2021 Third Door Media, Inc. All rights reserved.