bid_validate: Document User Validation Stage in BID Framework

View source: R/bid_validate.R

bid_validateR Documentation

Document User Validation Stage in BID Framework

Description

This function documents the validation stage, where the user tests and refines the dashboard. It represents stage 5 in the BID framework.

Usage

bid_validate(
  previous_stage,
  summary_panel = NULL,
  collaboration = NULL,
  next_steps = NULL,
  include_exp_design = TRUE,
  include_telemetry = TRUE,
  include_empower_tools = TRUE
)

Arguments

previous_stage

A tibble or list output from an earlier BID stage function.

summary_panel

A character string describing the final summary panel or key insight presentation.

collaboration

A character string describing how the dashboard enables collaboration and sharing.

next_steps

A character vector or string describing recommended next steps for implementation and iteration.

include_exp_design

Logical indicating whether to include experiment design suggestions. Default is TRUE.

include_telemetry

Logical indicating whether to include telemetry tracking and monitoring suggestions. Default is TRUE.

include_empower_tools

Logical indicating whether to include context-aware empowerment tool suggestions. Default is TRUE.

Value

A tibble containing the documented information for the "Validate" stage.

Examples

structure_input <- bid_notice(
  problem  = "Issue with dropdown menus",
  evidence = "User testing indicated delays"
) |>
  bid_interpret(
    central_question = "How can we improve selection efficiency?",
    data_story = list(
      hook = "Too many options",
      context = "Excessive choices",
      tension = "User frustration",
      resolution = "Simplify menu"
    )
  )

structure_result <- bid_structure(
  previous_stage = structure_input,
  concepts       = c("Principle of Proximity", "Default Effect")
)

anticipate <- bid_anticipate(
  previous_stage = structure_result,
  bias_mitigations = list(
    anchoring = "Provide reference points",
    framing   = "Use gain-framed messaging"
  )
)

bid_validate(
  previous_stage = anticipate,
  summary_panel = "Clear summary of key insights with action items",
  collaboration = "Team annotation and sharing features",
  next_steps = c(
    "Conduct user testing with target audience",
    "Implement accessibility improvements",
    "Add mobile responsiveness"
  )
)


bidux documentation built on Aug. 30, 2025, 1:12 a.m.