{"action":"created","issue":{"url":"https://api.github.com/repos/elixir-lang/elixir/issues/3970","labels_url":"https://api.github.com/repos/elixir-lang/elixir/issues/3970/labels{/name}","comments_url":"https://api.github.com/repos/elixir-lang/elixir/issues/3970/comments","events_url":"https://api.github.com/repos/elixir-lang/elixir/issues/3970/events","html_url":"https://github.com/elixir-lang/elixir/issues/3970","id":117488341,"number":3970,"title":"doctest: ignore lines that don't list an assertion value","user":{"login":"pdilyard","id":1459456,"avatar_url":"https://avatars.githubusercontent.com/u/1459456?v=3","gravatar_id":"","url":"https://api.github.com/users/pdilyard","html_url":"https://github.com/pdilyard","followers_url":"https://api.github.com/users/pdilyard/followers","following_url":"https://api.github.com/users/pdilyard/following{/other_user}","gists_url":"https://api.github.com/users/pdilyard/gists{/gist_id}","starred_url":"https://api.github.com/users/pdilyard/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/pdilyard/subscriptions","organizations_url":"https://api.github.com/users/pdilyard/orgs","repos_url":"https://api.github.com/users/pdilyard/repos","events_url":"https://api.github.com/users/pdilyard/events{/privacy}","received_events_url":"https://api.github.com/users/pdilyard/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":1,"created_at":"2015-11-18T01:07:54Z","updated_at":"2015-11-18T01:26:26Z","closed_at":null,"body":"It would be useful if doctests ignored lines that don't have an explicit value to assert to. For example:\r\n```elixir\r\n@doc \"\"\"\r\niex> {:ok, pid} = ListServer.start_link\r\n\"\"\"\r\n```\r\nThe above will fail to compile because of the following error:\r\n```elixir\r\n** (ExUnit.DocTest.Error) expected non-blank line to follow iex> prompt\r\n```\r\nOne possible work around for this is to do the following:\r\n```elixir\r\niex> {:ok, pid} = ListServer.start_link\r\niex> :ok\r\n:ok\r\n```\r\nBut this sort of clogs up the documentation."},"comment":{"url":"https://api.github.com/repos/elixir-lang/elixir/issues/comments/157567508","html_url":"https://github.com/elixir-lang/elixir/issues/3970#issuecomment-157567508","issue_url":"https://api.github.com/repos/elixir-lang/elixir/issues/3970","id":157567508,"user":{"login":"josevalim","id":9582,"avatar_url":"https://avatars.githubusercontent.com/u/9582?v=3","gravatar_id":"","url":"https://api.github.com/users/josevalim","html_url":"https://github.com/josevalim","followers_url":"https://api.github.com/users/josevalim/followers","following_url":"https://api.github.com/users/josevalim/following{/other_user}","gists_url":"https://api.github.com/users/josevalim/gists{/gist_id}","starred_url":"https://api.github.com/users/josevalim/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/josevalim/subscriptions","organizations_url":"https://api.github.com/users/josevalim/orgs","repos_url":"https://api.github.com/users/josevalim/repos","events_url":"https://api.github.com/users/josevalim/events{/privacy}","received_events_url":"https://api.github.com/users/josevalim/received_events","type":"User","site_admin":false},"created_at":"2015-11-18T01:26:26Z","updated_at":"2015-11-18T01:26:26Z","body":"Thank you. I am not sure because, although this feature could be useful, it also looks incomplete from the documentation perspective (we don't show the return value!) or may hide a bug (someone actually forgot to write the next line)."}}