Flow docs

[montogeek]

Hi!

This is the HTML generate by the following code:

// @flow
type FlightParams = {
  airline: string;
};

type Flight = {
  display: string
}

const Fligths = {
  /**
   * Test
   */
  getFlights: (data: FlightParams): Promise<Flight[]> => {
    return client.get(GET_FLIGHTS_ENDPOINT, { query: data })
      .then((response): Array<Flight> => {
        return response.flights.map((flight): Flight => {
          return {
            display: flight.label
          }
        });
      })
  }
}

export default Fligths;

Shouldn't it create docs for the params and return values?
I am using documentation 4.0.0-beta9

Thanks!

[arv]

Try using --document-exported.

There is still more work to do when it comes to outputting the types nicely.

[montogeek]

Same output

[montogeek]

Oh, is on beta10

[arv]

Hmmm... I guess the changes are not in the latest beta release. Try using master instead.

[montogeek]

I am a beta behind, updating...

[montogeek]

Still, same output

[montogeek]

When using master, all static methods were deleted from the output

[arv]

I have to look at it. --document-exported is a new feature and it is possible/likely I forgot some cases.

[arv]

I figured it out. I'm currently not handling var x = function () {} or var x = { ... } in the --document-exported case. I'll get a PR up but it will depend on some open PRs because they all touch the same area.

[montogeek]

No worries!
Thanks!!

[montogeek]

@arv I am getting the same behaviour using beta12.

My project is composed by modules that exports an object with methods:
foo.js

// @flow
const Foo = {
 /**
  * Desc
  */
  method: (params: <T>): Promise<T> => {};
}
export default Foo;

import foo from './path/foo.js'

export default {
 foo
}

I get a empty HTML output, without params and return values using --document-exported.
I get a nice output with all methods grouped by its module without using --document-exported.