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]