Skip to content

testing: unordered examples are underdocumented #18840

Closed

Description

@ALTree

Unordered examples (9323de3) are documented in go doc cmd/go:

If the last comment begins with "Unordered output:" then the output is compared to the comment, however the order of the lines is ignored

but not in go doc testing (which is the actual place where people will look for Examples documentation).

$ go doc testing | grep -c Unordered
0

and for the same reason there's nothing on https://golang.org/pkg/testing/#hdr-Examples.

Activity

  1. added this to the Go1.9Maybe milestone on Jan 29, 2017
  2. gopherbot commented on Feb 25, 2017

    @gopherbot
    Contributor

    CL https://golang.org/cl/37440 mentions this issue.

  3. locked and limited conversation to collaborators on Apr 10, 2018
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

      Milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions