Getting started on instance governance and documentation

Good documentation can be nearly as important as the actual instance implementation itself. A governance guide is a crucial resource that outlines your Marketo Engage instance setup details, covering topics such as program/folder structures, communication limits, and more. This living document is a reference for your Marketo Engage admin or power users, showcasing specific best practices and governing standards tailored to your Marketo Engage instance and organization.

But it doesn’t stop there. Your team may require supplemental enablement documents or training materials to enhance their proficiency with Marketo Engage. These resources could include interactive exercises, quizzes for access, or guidelines on permissible actions within Marketo Engage, benefiting all Marketo Engage users within your organization. Whether creating a comprehensive governance guide or documenting key setup aspects initially, recording decisions made during onboarding is key to ensuring success with Marketo Engage for your current team and future generations of new hires.

By understanding the importance of documentation and governance, this tutorial delves into the best practices sourced from expert peers Getting Started on Your Marketo Engage Governance and Training Documentation and How do you document your instance? to help you put a process in place and keep the documentation relevant to your internal users.

Why Documenting changes and decisions during instance implementation is essential

Approach your Marketo Engage documentation as if you’re guiding a new employee unfamiliar with the technology to onboard to the instance. It’s easy to overlook fundamental knowledge once you gained experience with Marketo Engage. As an administrator, you should ensure your enablement and governance documents cater to beginners. To facilitate new users’ learning, a practical method is incorporating definitions and best practices directly into your training materials.

Creating instance documentation during instance setup offers several benefits:

Ultimately, writing down the decisions you make during implementation will help you and your team be successful with Marketo Engage without depending on one or a handful of people to enforce the processes.

How to build your Marketo Engage instance governance and documentation

Step 1 - Outline key topics in your instance documentation

Define a setup of standards of what should be documented and what is not necessary to be documented. This will enable the organization to adopt the process. As you expand the document, it is important to document the why behind the setup. This helps other administrators as much as yourself to avoid wasting time on decisions that did not yield results.

Guide your governance and documentation plan by starting with the sample outline below:

* At minimum, your documentation should include the details of users and roles, program templates, and channels once the setup has been finished.

Step 2 - Create a Changelog

Another critical way of instance governance is to create a Changelog and enforce using it. Any time you change a setting in the ‘Admin’ section or an Operational program, your team should note it in a centralized place such as a shared spreadsheet. This can help you remember why you made a change and what it was like before. Fields you should document in the Changelog include:

What’s next?

Author

Amy Chiu, Adoption & Retention Marketing Manager, Adobe