Component Playground

A single page to test all documentation UI components with realistic talent-operations content.

DraftUpdated 2026-02-1013 min read

Decision Summary

The decision summary component provides an executive-friendly snapshot of the inputs, outputs, and pitfalls for a talent operations decision.

Decision Summary

When to use
When you need to decide whether to hire, upskill, or rebalance capacity for the next 6-12 weeks.
Inputs
  • Pipeline confidence (weighted probability of upcoming engagements)
  • Current billable capacity across all practice areas
  • Quarterly billable-hour targets from Finance
  • Skill coverage scores from the competency matrix
Outputs
  • Recommended action: hire, upskill, rebalance, or hold
  • Risk notes with confidence intervals
  • Timeline to full productivity for each option
Common mistakes
  • Optimism bias in pipeline -- treating 30% probable deals as confirmed demand
  • Treating skills as static -- not accounting for people learning on the job
  • Ignoring ramp-up time -- a new hire is not billable on day one
  • Confusing headcount with capacity -- three part-timers are not the same as two FTEs

This page is your one-stop QA surface for every content component in the documentation system. If it renders cleanly here, it renders cleanly everywhere. Each section below exercises one or more component with realistic talent-operations content so you can verify styling, interactivity, and accessibility in context.

Treat this as a living test harness. When you add a new component, add a section here first, verify it works, then use it in production pages.


Terminology

Every organisation has jargon. The glossary tooltip system lets authors mark terms inline so readers get definitions without leaving the page. Hover or tap any dotted-underlined term below.

In a typical talent operations cycle the COO monitors to ensure the stays lean, while the recruitment lead evaluates of incoming candidates. Finance tracks to set hiring budgets. Meanwhile, the competency team audits to identify capability gaps, and HR watches as a proxy for onboarding effectiveness. Every staffing request includes a payload so the system can match beyond job title. The weekly review compares the to the threshold that triggers a hire-or-wait decision.

Key terms that frequently appear together:

  • and are inversely related -- high bench drives low utilization.
  • feeds directly into the calculation.
  • is the hidden cost that makes harder to close quickly.

See the full list on the Glossary page.


Tabs

Tabs let you present role-specific or scenario-specific content without overwhelming the reader. Each tab set supports keyboard navigation and optional localStorage persistence.

Stakeholder views

The COO cares about delivery risk: can we staff confirmed projects on time and to quality? The weekly capacity delta is the north-star metric.

  • Review confirmed and probable demand side by side every Monday.
  • Escalate any practice area where capacity delta exceeds +2 FTE for two consecutive weeks.
  • Trigger a rebalance discussion before approving any new hire requisition.

Scenario complexity

You have one practice area (Cloud Engineering), 12 consultants, and a single confirmed project starting in 4 weeks that needs 8 people. The capacity delta is straightforward: 8 needed minus 10 available (2 are on leave) = -2. You are covered. Decision: hold.


Callouts and Collapsible Sections

Four callout variants for different semantic purposes, followed by collapsible detail blocks.

How capacity delta is used

The weekly capacity delta feeds into three downstream decisions: hiring triggers, rebalance proposals, and upskill programme intake. If the delta is positive for two consecutive weeks, the system flags an action.

A note on data freshness

All demand figures should be updated at least weekly. Stale pipeline data is the single largest source of bad capacity decisions. If your CRM data is more than 7 days old, treat pipeline confidence as zero.

Improved time-to-billable at Meridian Consulting

After implementing structured onboarding with pre-assigned shadow engagements, Meridian reduced average time-to-billable from 6.2 weeks to 3.1 weeks -- a 50% improvement that paid for itself within one quarter.


Formula Blocks

Formulas use the FormulaCard component for centered display with copy-to-clipboard, collapsible assumptions, and worked examples.

Capacity Delta

Capacity_Delta = (Projected_Demand_Hours - Available_Billable_Hours) / Standard_Weekly_Hours

Measures the gap between what the business needs and what the talent pool can deliver, expressed in FTE equivalents. A positive value means you need more people; a negative value means you have slack.

Pipeline-Adjusted Demand

Adjusted_Demand = Sum( Deal_Hours_i * Win_Probability_i )

Converts raw pipeline into risk-weighted demand by discounting each opportunity by its probability of closing. Prevents over-investment in speculative work.


Data Table

The sortable DataTable component handles tabular data with click-to-sort column headers, zebra striping, and mobile horizontal scroll.

Weekly Capacity Planning Dashboard

WeekConfirmed (h)Probable (h)Available (h)Delta (FTE)Action
W0632080360+1.0Hold
W07340120360+2.5Hire 1
W0828060400-1.5Rebalance
W09400100360+3.5Hire 2
W1036040400+0.0Hold
W1130090360+0.8Upskill

6 rows


Stat Grid

The StatGrid displays key metrics in a responsive card layout with optional trend indicators.

Utilization

78%

+3%

Bench Size

6 FTE

-2

Time-to-Billable

3.1 wk

-1.4 wk

Capacity Delta

+2.5 FTE

+0.8

Figures

The Figure component wraps visual content with a semantic figcaption, numbered label, and optional download button.

Demand vs Capacity (hours)W01W06W12DemandCapacity

Figure 1.Demand vs. Capacity trend over a 12-week planning horizon. The shaded area represents risk-weighted probable demand.

Download
Skill Coverage by Practice AreaCloudDataAdvisoryCyberStrategyDeliveryTechDomainPeopleSales85%92%96%58%78%55%62%80%94%88%60%35%95%90%50%97%88%75%40%55%82%30%65%28%

Figure 2.Skill coverage heatmap across six practice areas. Darker cells indicate stronger coverage; white cells indicate critical gaps.


Mermaid Diagram

Decision flow rendered via the MermaidDiagram component. Includes copy-source and view-source actions.

Talent Decision Flow


Code Blocks

Two code blocks with syntax highlighting and copy buttons -- one pseudocode, one JSON payload.

js
// Pipeline-Adjusted Demand Calculator
function calculateAdjustedDemand(deals) {
  return deals
    .filter(deal => deal.winProbability >= 0.10)
    .reduce((total, deal) => {
      const weighted = deal.hours * deal.winProbability;
      console.log(`${deal.name}: ${deal.hours}h × ${deal.winProbability} = ${weighted}h`);
      return total + weighted;
    }, 0);
}

const pipeline = [
  { name: "Acme Cloud Migration",  hours: 200, winProbability: 0.80 },
  { name: "Beta Data Platform",    hours: 300, winProbability: 0.50 },
  { name: "Gamma Advisory Review", hours: 100, winProbability: 0.20 },
];

const adjustedDemand = calculateAdjustedDemand(pipeline);
// => 330 weighted hours
json
{
  "id": "rc-0042",
  "role": "Senior Cloud Architect",
  "industry": "Financial Services",
  "seniority": "Principal",
  "location": "London / Remote",
  "skills": ["AWS", "Terraform", "Kubernetes", "FinOps"],
  "certifications": ["AWS Solutions Architect Pro"],
  "clearance": "SC cleared",
  "constraints": {
    "maxTravel": "20%",
    "startAfter": "2026-03-01",
    "minEngagementWeeks": 12
  }
}

This page renders with status: draft and lastUpdated: 2026-02-10 in the frontmatter. You should see both the status badge and the date in the meta row below the title. The sidebar should list this page under Tools > Reference, and the previous/next links at the bottom should navigate to adjacent pages in the Tools area.

QA checklist

Use this list to verify that all interactive features are working:

  • Table of Contents on the right shows all H2 sections
  • Copy buttons work on both code blocks and formula cards
  • All three tabs switch in the stakeholder view; both tabs switch in the scenario view
  • Glossary Term tooltips open on hover and show definitions
  • Data table scrolls horizontally on mobile and columns sort on click
  • Callout variants display distinct colours and icons
  • Collapsed sections expand and collapse
  • Mermaid diagram renders and the "View source" toggle works
  • Stat grid cards display trend arrows correctly
  • Figure captions show numbered labels
  • Previous/Next navigation links appear at the bottom