Edit on GitHub

Review: Published Solution Guides

Reviewed: July 22, 2026

Scorecard

Rank Solution Guide Score Verdict
1 AAP HA/DR on OpenShift 9.8/10 Reference-grade implementation guide with validated test scenarios, observed SLAs, and production-hardened failover runbooks
2 Windows Certificate Rotation with AI Risk Analysis 9.8/10 Elite AIOps guide: three decision paths, three test scenarios with syntax-highlighted output, arcade demo, video, observability callout, graceful fallback, and success metrics
3 Zero Trust Architecture with Ansible 9.6/10 Five integrated use cases demonstrating defense-in-depth: OPA policy gates, SPIFFE workload identity, JIT credentials, and break-glass recovery with phased implementation roadmap
4 AI-Assisted Ansible Developer Experience 9.5/10 Comprehensive DevTools guide with four installation methods, MCP integration, and enterprise maturity model from individual to governed
5 OpenShift EDA + Kafka Event Pipeline 9.2/10 Deep integration guide: full Kafka/Serverless/EDA pipeline with custom credential types, alternative architectures, and strong validation
6 AIOps with Splunk and EDA 8.9/10 Deepest multi-use-case guide; three integration patterns with strong validation and troubleshooting
7 Automated Incident Remediation with IBM Instana 8.9/10 Dual-path architecture (EDA vs native); per-use-case operational impact and unusually complete validation
8 High-Availability AAP with EDB PostgreSQL DR 8.7/10 Reference-grade VM-based DR architecture with diagrams, runbooks, and failback procedures
9 Unlock AIOps with ServiceNow LEAP and Ansible MCP server 8.7/10 Strong LEAP/MCP governance story with MTTR focus, customer evidence, multi-agent visibility
10 AIOps automation with Ansible 8.5/10 Strong foundational reference architecture; best systems narrative, observability catalog, and playbook source mapping
11 AI Infrastructure automation with Ansible 7.3/10 Clear two-collection story (infra.ai + redhat.ai); needs framework alignment and deeper validation
12 Intelligent Assistant with Red Hat AI Inference Server 6.9/10 Strong hands-on RHAIIS + Lightspeed hookup; weakest framework alignment of published guides

How This Was Scored

Each guide was evaluated against the quality scoring model from the Best Practices for Writing Solution Guides:

Category Weight
Outcome Clarity 20%
Architecture Clarity 20%
Technical Executability 25%
Validation/Testability 15%
Production Readiness Info 10%
Business Framing 10%

Score each category 1-5. Multiply by weight. Final score out of 10. Any category below 3 means revise before publishing.


Guide Reviews


1. High Availability and Disaster Recovery for AAP on OpenShift

File: README-AAP-HA-DR-OpenShift.md Score: 9.8 / 10

Category Score
Outcome Clarity (20%) 5
Architecture Clarity (20%) 5
Technical Executability (25%) 5
Validation/Testability (15%) 5
Production Readiness (10%) 5
Business Framing (10%) 4
Stats: ~8,500 words 12+ YAML blocks 1 clickable architecture image + 1 Mermaid diagram 6 major sections with appendix Validated test scenarios table

Strengths:

Weaknesses:

Suggestions:

  1. Add a brief executive summary or “Quick Start” at the top for architects who need the architecture without the full implementation
  2. Consider a companion reference card (one-pager) with the validated SLA table and failover cheat sheet
  3. Add a cost/resource estimate section (node count, storage, operator overhead)

2. Windows Certificate Rotation with AI Risk Analysis

File: README-AIOps-Windows-Cert-Rotation.md Score: 9.8 / 10

Category Score
Outcome Clarity (20%) 5
Architecture Clarity (20%) 5
Technical Executability (25%) 4.75
Validation/Testability (15%) 5
Production Readiness (10%) 5
Business Framing (10%) 5
Stats: ~4,400 words 7 YAML blocks 1 hero image + 1 Mermaid diagram + 6 screenshots Arcade embed + YouTube video 4 walkthrough steps (with 3a/3b branching) 3 validation test paths with custom ansible-output syntax highlighting Observability platform callout

Strengths:

Weaknesses:

Suggestions:

  1. Add a link to a GitHub repo with the complete playbook set when available
  2. Consider removing the inline style directive from the Mermaid diagram (or keep it – it looks good)

3. Zero Trust Architecture with Ansible Automation Platform

File: README-ZTA.md Score: 9.6 / 10

Category Score
Outcome Clarity (20%) 5
Architecture Clarity (20%) 5
Technical Executability (25%) 5
Validation/Testability (15%) 5
Production Readiness (10%) 4.5
Business Framing (10%) 4
Stats: ~7,800 words 12+ YAML/bash code blocks 5 integrated use cases Per-use-case validation suites 9-row troubleshooting table Phased implementation roadmap with success criteria Measuring Success metrics table

Strengths:

Weaknesses:

Suggestions:

  1. Add a Mermaid diagram showing the defense-in-depth rings and OPA policy enforcement flow
  2. Consider recording a demo of the break-glass recovery scenario – it’s the most dramatic and teachable moment
  3. Add an embedded Arcade walkthrough for the workshop if available

4. AI-Assisted Ansible Developer Experience

File: README-Ansible-DevTools.md Score: 9.5 / 10

Category Score
Outcome Clarity (20%) 4.5
Architecture Clarity (20%) 5
Technical Executability (25%) 5
Validation/Testability (15%) 4
Production Readiness (10%) 5
Business Framing (10%) 5
Stats: ~4,800 words 3 Mermaid diagrams + multiple code blocks (bash, JSON, YAML) 4 installation methods with step-by-step MCP server configuration section Comprehensive comparison table

Strengths:

Weaknesses:

Suggestions:

  1. Add a screenshot or two showing the dev container experience (VS Code with Ansible extension running inside the container)
  2. Strengthen the validation section with a more meaningful test (e.g., scaffold a role, lint it, run molecule)
  3. Add a “Common questions from leadership” FAQ addressing cost justification for Dev Spaces infrastructure

5. OpenShift EDA + Kafka Event Pipeline

File: README-OpenShift-EDA-Kafka.md Score: 9.2 / 10

Category Score
Outcome Clarity (20%) 4
Architecture Clarity (20%) 5
Technical Executability (25%) 5
Validation/Testability (15%) 5
Production Readiness (10%) 4
Business Framing (10%) 4
Stats: ~5,200 words 15+ YAML/shell blocks 1 Mermaid diagram 7 numbered walkthrough steps Per-stage validation table + 7-row troubleshooting table

Strengths:

Weaknesses:

Suggestions:

  1. Add a “What you can build on this” section with 2-3 concrete examples (e.g., auto-apply network policies to new namespaces, alert on label violations)
  2. Consider adding a simple governance action in a “bonus step” to show immediate value beyond logging
  3. Add cost/resource notes for the Kafka + Serverless stack (storage, operator overhead)

6. AIOps with Splunk and Event-Driven Ansible

File: README-AIOps-Splunk-ITSI.md Score: 8.9 / 10

Category Score
Outcome Clarity (20%) 5
Architecture Clarity (20%) 4
Technical Executability (25%) 4
Validation/Testability (15%) 5
Production Readiness (10%) 4
Business Framing (10%) 5
Stats: ~6,800 words 15 YAML blocks 1 hero image + 1 architecture image 17 walkthrough subsections

Strengths:

Weaknesses:

Suggestions:

  1. Fix or remove the dead “Incident Response Timeline” TOC entry
  2. Provide a distinct diagram (or clear caption) separating predictive ITSI topology from generic webhook flow
  3. Unify Prerequisites with every module used in excerpts (add f5networks.f5_modules, amazon.aws)

7. Automated Incident Remediation with IBM Instana

File: README-Instana-AIOps.md Score: 8.9 / 10

Category Score
Outcome Clarity (20%) 4
Architecture Clarity (20%) 5
Technical Executability (25%) 4
Validation/Testability (15%) 5
Production Readiness (10%) 4
Business Framing (10%) 5
Stats: ~4,300 words 8 YAML blocks 1 hero image + 2 architecture diagrams 8 numbered steps + 3 use cases + optional AI section

Strengths:

Weaknesses:

Suggestions:

  1. Fix the “an governed” typo in the Overview
  2. Add a subtitle or alias so “Integration Architecture” maps to the framework’s Workflow section for reviewers
  3. Consider adding a Mermaid version of the dual-path topology for inline rendering on GitHub Pages

8. High-Availability AAP with EDB PostgreSQL DR

File: README-EDB.md Score: 8.7 / 10

Category Score
Outcome Clarity (20%) 4.5
Architecture Clarity (20%) 5
Technical Executability (25%) 4
Validation/Testability (15%) 4
Production Readiness (10%) 4
Business Framing (10%) 4.5
Stats: ~7,130 words 1 YAML block 3 Mermaid diagrams (architecture, data flow, failover sequence) 6 phases, 23 titled substeps

Strengths:

Weaknesses:

Suggestions:

  1. Validate and fix the unified inventory INI grouping so DC2 host/variable assignments are unambiguous
  2. Add a short “Support and boundaries” note clarifying Red Hat vs EDB support scope
  3. For 3-5 key commands (podman ps, efm cluster-status, pg_is_in_recovery), show verbatim expected output

9. Unlock AIOps with ServiceNow LEAP and Ansible MCP server

File: README-AIOps-ServiceNow.md Score: 8.7 / 10

Category Score
Outcome Clarity (20%) 5
Architecture Clarity (20%) 4.5
Technical Executability (25%) 4
Validation/Testability (15%) 4
Production Readiness (10%) 5
Business Framing (10%) 5
Stats: ~3,800 words 2 YAML blocks 1 hero image + 1 SVG architecture diagram + 1 Mermaid diagram 4 walkthrough steps + 4 verification artifacts

Strengths:

Weaknesses:

Suggestions:

  1. Add a short API-based alternative for Step 2 (connector setup)
  2. Add a concrete multi-agent scenario showing two agents updating the same incident

10. AIOps automation with Ansible

File: README-AIOps.md Score: 8.5 / 10

Category Score
Outcome Clarity (20%) 4
Architecture Clarity (20%) 5
Technical Executability (25%) 4
Validation/Testability (15%) 3
Production Readiness (10%) 4.5
Business Framing (10%) 4.5
Stats: ~7,500 words 8 YAML blocks 6+ substantive workflow/concept images 4 pipeline phases with 16 numbered substeps

Strengths:

Weaknesses:

Suggestions:

  1. Add verbatim expected output for each pipeline stage
  2. Sanitize YAML examples so template names are plain strings suitable for copy-paste
  3. Insert the KB blockquote under the H1 per publishing standards

11. AI Infrastructure automation with Ansible

File: README-IA.md Score: 7.3 / 10

Category Score
Outcome Clarity (20%) 4
Architecture Clarity (20%) 4
Technical Executability (25%) 4
Validation/Testability (15%) 3
Production Readiness (10%) 3
Business Framing (10%) 3
Stats: ~1,927 words 3 YAML blocks 1 workflow screenshot ~8-10 major phases

Strengths:

Weaknesses:

Suggestions:

  1. Add an Overview section with a problem statement and consolidated Prerequisites table
  2. Expand Validation with sample success output and a 3-5 row troubleshooting table
  3. Add persona mapping and business framing

12. Intelligent Assistant with Red Hat AI Inference Server

File: README-Intelligent-Assistant-RHAIIS.md Score: 6.9 / 10

Category Score
Outcome Clarity (20%) 4
Architecture Clarity (20%) 3
Technical Executability (25%) 3
Validation/Testability (15%) 4
Production Readiness (10%) 3
Business Framing (10%) 4
Stats: ~1,625 words 0 YAML blocks (2 YAML snippets in ~~~ fences) Arcade demo + 1 GPU screenshot ~12-14 major operations

Strengths:

Weaknesses:

Suggestions:

  1. Add an Overview with problem statement and a Workflow section with a simple diagram
  2. Fix podman run formatting; convert ~~~ to ` ```yaml `
  3. Add a Validation heading with a troubleshooting table

Cross-Cutting Observations

What changed since the May 2026 review:

Patterns that work well across guides:

Recurring gaps across guides:

  1. Source repo links – many guides show code excerpts but don’t link to a full runnable repo
  2. Cost/resource estimates – only Windows Cert and DevTools address this consistently
  3. Inline mermaid styles – Windows Cert uses a style directive (minor, renders well)
  4. YAML copy-paste fidelity – AIOps guide still embeds HTML emoji in YAML name fields
  5. ansible-output highlighting – now available site-wide; other guides with playbook output should adopt it

Ranking rationale: