Skip to content

Clarify/Improve Application.Run Terminology #4334

@tig

Description

@tig

"Application.Run" is really Begin -> Run -> Layout/Draw -> End -> Stop and includes RunState. Determine if there's a better name for all this functionality.

Background:
The current Run terminology encompasses multiple concepts:

  • Beginning a run (Begin)
  • The actual run loop (Run/RunLoop)
  • Layout and drawing during each iteration
  • Ending a run (End)
  • Stopping a run (Stop, RequestStop)
  • Managing run state (RunState)

Questions to Answer:

  • Is "Run" the best term for this overall lifecycle?
  • Should the different phases have more distinct naming?
  • How does this relate to the Application lifecycle (Init/Shutdown)?
  • What terminology would be clearest for users?

Tasks:

  • Analyze current Run terminology and usage
  • Propose improved naming scheme
  • Get community feedback on proposals
  • Create migration/deprecation plan
  • Update documentation with clearer explanations

Acceptance Criteria:

  • Clear, consistent terminology for run lifecycle
  • Documentation clearly explains each phase
  • Backward compatibility maintained
  • Community consensus on naming

Related to: Issue #4329

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

Projects

Status

No status

Milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions