bid_notice: Document User Notice Stage in BID Framework

In bidux: Behavioral Insight Design: A Toolkit for Integrating Behavioral Science in UI/UX Design

Document User Notice Stage in BID Framework

Description

This function documents the observation and problem identification stage. It represents stage 2 in the BID framework and now returns a structured bid_stage object with enhanced metadata and external mapping support.

Usage

bid_notice(
  previous_stage,
  problem,
  theory = NULL,
  evidence = NULL,
  quiet = NULL,
  ...
)

Arguments

previous_stage	A tibble or list output from the previous BID stage function (typically bid_interpret).
problem	A character string describing the observed user problem.
theory	A character string describing the behavioral theory that might explain the problem. If NULL, will be auto-suggested using external theory mappings.
evidence	A character string describing evidence supporting the problem.
quiet	Logical indicating whether to suppress informational messages. If NULL, uses getOption("bidux.quiet", FALSE).
...	Additional parameters. Deprecated parameters (e.g., 'target_audience') will generate warnings if provided.

Value

A bid_stage object containing the documented information for the "Notice" stage with enhanced metadata and validation.

Examples

interpret_result <- bid_interpret(
  central_question = "How can we improve user task completion?",
  data_story = list(
    hook = "Users are struggling with complex interfaces",
    resolution = "Simplify key interactions"
  )
)

# Auto-suggested theory
bid_notice(
  previous_stage = interpret_result,
  problem = "Users struggling with complex dropdowns and too many options",
  evidence = "User testing shows 65% abandonment rate on filter selection"
)

# With explicit theory
notice_result <- bid_notice(
  previous_stage = interpret_result,
  problem = "Mobile interface is difficult to navigate",
  theory = "Fitts's Law",
  evidence = "Mobile users report frustration with small touch targets"
)

summary(notice_result)

bidux documentation built on Nov. 20, 2025, 1:06 a.m.