Skip to main content

Knowledge Base Concepts

ServiceOps Knowledge Management provides a centralized repository for articles, guides, and FAQs that enables self-service support and reduces ticket volume by offering comprehensive, accessible information. The Knowledge Base is designed for both authenticated users and public visitors, allowing independent issue resolution without requiring registration or login to view articles. Content is managed by Subject Matter Experts (SMEs), ensuring high quality and accuracy.

Key Characteristics

  • Public Access: Articles are freely available without requiring login
  • Rich Content Support: Supports text, images, audio, and video content
  • Organized Structure: Articles are organized in folders for easy navigation
  • Search Capabilities: Full-text search with keyword and tag-based filtering
  • Feedback System: Users can provide helpful/not helpful feedback on articles
  • Version Control: Draft and publish workflow with approval processes

Knowledge Base Structure

The Knowledge Base organizes content through a hierarchical folder structure that allows for logical categorization of articles. It supports various content types to accommodate different information needs.

Article Organization

  • Folders: Primary organizational units that group related articles
  • Subfolders: Secondary organization for more specific topics
  • Tags: Additional metadata for improved searchability
  • Categories: Predefined groupings for common article types

Content Types

  • How-to Guides: Step-by-step instructions for common tasks
  • Troubleshooting Articles: Solutions for specific problems and errors
  • FAQ Collections: Answers to frequently asked questions
  • Best Practices: Recommended approaches and procedures
  • Reference Materials: Technical specifications and documentation

Search and Discovery

The Knowledge Base provides multiple methods to help users find relevant information:

  • Full-text Search: Searches across article titles and content
  • Keyword Search: Targeted search using specific keywords
  • Tag-based Search: Search using article tags and metadata
  • Folder Navigation: Browse articles by organizational structure
  • Context-based Suggestions: Articles suggested based on current request context
  • AI-powered Recommendations: Machine learning-based article recommendations
  • Popular Articles: Most read and most helpful articles

Content Management Features

The Knowledge Base includes a comprehensive rich text editor and maintains article history and version control.

Rich Text Editor

  • Text Formatting: Bold, italic, underline, and other formatting options
  • Media Support: Images, audio, and video content embedding
  • Tables and Lists: Structured content presentation
  • Links and References: Internal and external link support

Article Metadata

Each article includes comprehensive metadata for better organization and discovery:

  • Title: Clear, descriptive article title
  • Description: Brief summary of article content
  • Tags: Keywords for improved searchability
  • Folder Assignment: Organizational placement
  • Expiry Date: Optional expiration for time-sensitive content
  • Author Information: Creator and last modified details

Version Control

The Knowledge Base maintains article history and version control:

  • Draft Management: Save work-in-progress without publishing
  • Edit History: Track all changes made to articles
  • Audit Trail: Complete log of all article modifications
  • Rollback Capability: Revert to previous versions if needed

User Interaction

Users can access Knowledge Base content both publicly and as authenticated users, providing feedback and additional features.

Public Access

  • Browse Articles: Navigate through folders and categories
  • Search Content: Use search functionality to find specific information
  • View Media: Access images, videos, and other embedded content
  • Print Articles: Generate printable versions of articles

Authenticated User Features

Logged-in users have additional capabilities:

  • Like/Dislike: Provide feedback on article helpfulness
  • Save Favorites: Bookmark frequently used articles
  • Comment: Add comments and suggestions (if enabled)
  • Share: Share articles with colleagues

Feedback System

The Knowledge Base includes a comprehensive feedback system:

  • Helpful/Not Helpful: Binary feedback on article usefulness
  • Usage Analytics: Track article views and popularity
  • Search Analytics: Monitor search patterns and popular queries
  • Content Performance: Identify high-performing and underperforming articles

Integration with Other Modules

The Knowledge Base integrates with various other modules to enhance workflow and provide comprehensive information:

Incident Management
  • Suggested knowledge for incident creation
  • Solution linking to incident resolutions
  • Problem resolution to knowledge article conversion
  • Workflow integration and automation
Problem Management
  • Documenting root cause analysis and permanent fixes.
  • Linking known error records to articles detailing workarounds.
  • Converting successful problem resolutions into new knowledge articles.
Change Management
  • Change procedure documentation
  • Procedure references in change requests
  • Approval context and references
  • Post-implementation knowledge creation from change outcomes
Release Management
  • Documenting release plans, build procedures, and backout plans.
  • Providing knowledge articles detailing new features included in a release.
  • Linking release records to articles for user communication.
Asset Management
  • Asset configuration guides
  • Maintenance procedures
  • Troubleshooting documentation
  • Setup and installation guides
CI Management (CMDB)
  • Linking CIs to relevant articles for configuration and troubleshooting.
  • Documenting relationships between CIs and business services.
  • Storing CI-specific maintenance procedures and guides.
Project Management
  • Documenting project plans, best practices, and lessons learned.
  • Linking project tasks to relevant how-to guides and procedures.
  • Storing documentation for project deliverables.

Best Practices

To maximize the effectiveness of your Knowledge Base, consider these best practices:

Content Creation
  • Develop clear, concise, and search-friendly titles.
  • Structure content logically with headings and subheadings.
  • Regularly update content to ensure accuracy and relevance.
  • Incorporate user feedback for continuous improvement.
Organization
  • Implement intuitive folder structures and consistent tagging.
  • Utilize cross-references to link related articles.
  • Maintain article history and track changes with version control.
Quality Assurance
  • Establish regular content review processes.
  • Use approval workflows for quality control.
  • Set appropriate expiry dates for time-sensitive content.
  • Monitor article usage and search effectiveness to identify areas for improvement.