Problem
Stage.mount() documentation shows both class and instance usage but doesn't clarify which is correct or the differences.
Affected Files
Documentation: /home/matthias/projects/synapse/docs/testing/TESTING_GUIDE.md (lines 54-55, 149)
Issue Details
Severity: LOW
Impact: Can infer from context but not explicit
Ambiguous Examples
stage.mount('my-component', MyComponent); // Passes class
stage.mount('user-service', new UserService()); // Passes instance
Unclear Aspects
- Does mount accept both classes and instances?
- If it accepts both, what are the differences?
- What's the lifecycle of mounted components?
- When should you use class vs instance?
- Does mount instantiate the class automatically?
Recommended Enhancement
Add clarification:
// Option 1: Mount class (Stage will instantiate)
stage.mount('my-component', MyComponent);
// Option 2: Mount instance (use existing instance)
stage.mount('user-service', new UserService(config));
// Differences:
// - Class: Stage manages lifecycle, can create multiple instances
// - Instance: You manage lifecycle, shared singleton
Priority
LOW - Documentation polish for clarity
References
User Story
As a developer using the Theater testing system, I want clear mount() documentation, so that I understand when to pass classes vs instances and the lifecycle implications.
Acceptance Criteria
Problem
Stage.mount() documentation shows both class and instance usage but doesn't clarify which is correct or the differences.
Affected Files
Documentation:
/home/matthias/projects/synapse/docs/testing/TESTING_GUIDE.md(lines 54-55, 149)Issue Details
Severity: LOW
Impact: Can infer from context but not explicit
Ambiguous Examples
Unclear Aspects
Recommended Enhancement
Add clarification:
Priority
LOW - Documentation polish for clarity
References
/home/matthias/projects/synapse/DOCUMENTATION_ISSUE_LOG.md(Issue feat: Add Neuroplasticity for self-healing and adaptive optimization #13)/home/matthias/projects/synapse/DOCUMENTATION_FIXES_NEEDED.md(FIX-13)User Story
As a developer using the Theater testing system, I want clear mount() documentation, so that I understand when to pass classes vs instances and the lifecycle implications.
Acceptance Criteria