IBM Co-Marketing Guide – A global knowledge base

Fig. 1 – IBM Co-Marketing guide, approval flow

Fig. 2 – IBM Co-Marketing guide, All Markets, English

Fig. 3 – Guide version and language switcher

About IBM

International Business Machines Corporation (IBM) is a global technology and consulting company delivering enterprise solutions across cloud, artificial intelligence, security, infrastructure and software. IBM collaborates with organizations, governments and partners to design, build and operate scalable solutions that address industry-specific challenges. Combining product engineering, services and partner ecosystems, IBM helps accelerate digital transformation and drive measurable business outcomes worldwide.

Fig. 4 – Using the Color Contrast Analyser to make sure accessibility criterias are met

Fig. 5 – A logged in editor seeing the document updates, added and deleted items

Summary

The IBM Co-Marketing Guide was designed as more than just a knowledge base — it introduced an innovative live document management system. Editors and admins could update content directly within pages, annotate, request changes, approve or reject drafts, and publish updates in real time. This ensured that every IBM Business Partner and IBMer always had access to the latest, compliant version of the guide.

Overview

IBM’s global Co-Marketing team required a platform that centralized multiple guides, each with geography-specific rules and regulations. The solution needed to not only deliver fast, self-service access to knowledge, but also support continuous live updates without relying on static PDFs. The IBM Co-Marketing Guide was built as a hybrid knowledge base and document management system, enabling:

Structured and searchable knowledge base content
Live in-page editing, annotations, and approvals
Real-time synchronization across geographies and languages

The challenge

Fragmentation: Regional versions of the guide were scattered and inconsistently updated
Slow updates: Static PDFs required manual distribution, often creating confusion and compliance risks
Rising expectations: Partners and IBMers wanted instant, accurate answers
Compliance: Frequent regulation changes required a fast, transparent update process

Research & insights

Industry benchmarks confirmed that users increasingly prefer self-service knowledge bases:

91% would use a knowledge base if it were tailored to their needs
40% prefer self-service over direct contact
57% of support calls come from users who already tried to find answers online

Sources: HBR, Oracle, Forbes, Atlassian, Social Media Today

Audience: Gen X and Millennial IBMers and partners — fast-paced, digital-first professionals who value clarity and speed.

Insight: A static guide would not meet expectations. The platform needed to behave like a living system with instant updates, annotations, and approvals.

Fig. 6 – Change checking by comparison with previous versions

Fig. 7 – Entering edit mode transforms each page into editable modules

Fig. 8 – Publish selected updates in the selected guide versions on a specific date

Fig. 9 – Return changes to editor instantly with a reason

Core features

Secure login (W3 ID) with role-based access
Global navigation: select geography, market, country, then enter the correct guide
Homepage modules: table of contents, “What’s New” updates, and direct content navigation
Advanced search: keyword results with highlights and deep links to chapters
Print to PDF: eco-friendly versions of selected chapters or full guides
FAQs and contact form for additional support
Advanced search: keyword results with highlights and deep links to chapters

Roles & permissions

Business Partner (BP): Access guides, search, print, track updates
IBMer: Navigate across multiple guides and versions
Editor: Draft and lock updates, annotate, and submit for approval
Admin (Super User): Annotate editor drafts, request changes, approve updates, schedule releases, and publish directly within the application

Live document management & approval workflow

At the heart of the application is the live updating system:

In-page editing: Content can be updated directly within the page interface
Annotations & change requests: Admins can mark sections, leave comments, and request revisions before approval
Approval workflow:
- Editors create or update drafts
- Admins review, annotate, edit further, approve, or reject
- Approved updates go live immediately or are scheduled for future release
Audit trail: Every change is logged with editor, approver, timestamps, and both old and new content versions.

This system effectively turned the guide into a living document, with transparency and accountability built into every update.

Innovation

The IBM Co-Marketing Guide was not just a digital manual — it was an enterprise-grade innovation in live knowledge management.

Direct, in-page editing and publishing eliminated reliance on static files
Annotations and requests kept the editing workflow collaborative
Approval scheduling allowed compliance teams to control release timing
Version history and audit logs ensured accountability and regulatory alignment

This approach allowed IBM to maintain real-time accuracy, meet compliance standards across multiple geographies, and build trust with users who relied on up-to-date information.

Fig. 10 – Auditor view

Fig. 11 – Change guide and language in the same form

Fig. 12 – Search module with history and suggestions

Fig. 13 – Guide layout content consistency

Impact

Efficiency: Reduced redundant support calls by enabling instant self-service
Accuracy: Live updates ensured partners always accessed the latest version
Adoption: Widely used by IBMers and Business Partners worldwide
Scalability: Easily cloned and localized for new languages and regions

The IBM Co-Marketing Guide established a new standard for enterprise knowledge bases, merging compliance, usability, and live document management into one system.

← Previous Next →

Imagine your next big idea becoming a reality. → Get in touch and help us create, innovate, and inspire in ways that leave a mark on the world.