bid_notice {bidux}R Documentation

Document User Notice Stage in BID Framework

Description

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

Usage

bid_notice(problem, theory = NULL, evidence = NULL, target_audience = NULL)

Arguments

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.

target_audience

Optional character string describing the target audience.

Value

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

Examples

# Basic usage with auto-suggested theory
notice_result <- bid_notice(
  problem = "Users struggle with complex dropdown menus containing too many options",
  evidence = "User testing shows 65% abandonment rate on filter selection"
)

# Print shows human-friendly summary
print(notice_result)

# Access underlying data
summary(notice_result)

# Check stage and metadata
get_stage(notice_result)
get_metadata(notice_result)

# With explicit theory
notice_explicit <- bid_notice(
  problem = "Mobile interface is difficult to navigate",
  theory = "Fitts's Law",
  evidence = "Mobile users report frustration with small touch targets",
  target_audience = "Mobile users with varying technical expertise"
)


[Package bidux version 0.1.0 Index]