alisinabh

alisinabh

Hi

I’ve recently faced a problem with doc tests on html documents:

Here is my code and docs:

@doc """
Does something good!

## Examples
iex> Module.do_something
{:ok, 123}

iex> Module.do_something
:error
"""
def do_something() do
  ...
end

In the documents the output will be like:

Examples

iex> Module.do_something
iex> Module.do_something :error

As you can see the tuple in the first example is missing in the docs. Am i doing something wrong?

Showing Posts 1 to 2

voughtdq

voughtdq

Hi, have you put four spaces before the doc tests? It looks like you haven’t, but it might have just been caused by copy/paste.

@doc """
Articulates the given frob.

## Examples

    iex> frob = %Frob{}
    iex> Articulator.articulate(frob)
    {:ok, %Frob{articulated: true}}

"""
def articulate(%Frob{}) do
  {:ok, %Frob{articulated: true}}
end

Until I changed my doctests to what you see above, weird things happened.

alisinabh

alisinabh OP

Yes that was my problem. :slight_smile:

Thank you very much

— All posts loaded —

Where Next? Top

Trending in Questions Top

RSP87
I’m working on a project that simulates the bumbl example in the programming phoenix book. It acts almost like an email client. We have a...
New
nseaSeb
Hello, I know there is an approach for handling lists that allows for optimized traversal, but I can’t recall the specific method (somet...
New
kpanic
Hi everyone, I am toying with the idea of building a “match maker” for giving personal help to people that wants to start coding. I sta...
New
brecabral
Documentation While reading the Scoped Routes section, I noticed that the documentation currently refers to a problem without explainin...
New
velrest
So my question is quite simple and i have found no conclusive answer on forum, google or AI. Should we use :erlang.float for Integer to ...
New
asweet-confluent
I recently noticed that Elixir’s Logger defaults its primary log level to :debug when no :logger, :level application configuration is pre...
New
apz
I’m new to elixir and just tried to install the elixirLS extension for VScode(ium) and it is throwing some errors that I would like help ...
New

Other Trending Topics Top

GenericJam
Edit: 2026 May 15 - This post is archived. Mob is alive!! Main docs: mob v0.7.11 — Documentation A bit of explanation for the slightly c...
New
JesseHerrick
Hey, I’m Jesse and I’m the main contributor behind Dexter, a full-featured, lightning-fast Elixir LSP optimized for large codebases. It s...
New
mudasobwa
I am happy to introduce the very α version of the new programming language compiled to BEAM. Welcome Cure. It has literally three kille...
New
marciok
Hi there! We created Gust: A task orchestrator inspired by Airflow. For those who have never heard about Aiflow, it’s a Python-based wor...
New
mhanberg
Hi everyone! The first release candidate for the Expert language server project is now available! We’ve published a press release detai...
New
jimsynz
Beam Bots (or just BB for short) is a framework for building fault-tolerant robotics applications in Elixir using familiar OTP patterns. ...
New

We're in Beta

About us Mission Statement

Options

Thread Display Mode




Thread Preview

Skip Thread Previews