akka/akka-core

TestFSMRef API example invalid

Open

#15,668 opened on Aug 14, 2014

View on GitHub
 (1 comment) (0 reactions) (0 assignees)Scala (3,547 forks)batch import
1 - triagedhelp wantedt:docst:testing

Repository metrics

Stars
 (13,277 stars)
PR merge metrics
 (Avg merge 8d 19h) (10 merged PRs in 30d)

Description

TestFSMRef API documentation is incorrect -- the TestFSMRef creation is missing a closing parenthesis, it uses the Ev() method which was removed in 2.0, it lacks the declaration of an ActorSystem, lacks a value for akka.util.Timeout, and possibly additional issues.

The documentation on Testing (3.9) suffers from similar, but worse, issues (imports are often omitted, as well as declarations of the test classes). And there's no documentation on how to use both TestKit and TestActorRef or TestFSMRef at the same time, or if it's even possible.

The use of Ev() is also present in other sections of the API, such as FSM.

Contributor guide

Research direction
Read the test documentation in the repository and correct the code snippets for TestFSMRef.
Tech stack
scala
Domain
testing
Issue type
Documentation
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
2
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
1-3 hours
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
Fresh
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
Clear
Prerequisites
Git
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
70