documentationjs / documentation

:book: documentation for modern JavaScript
http://documentation.js.org/
Other
5.79k stars 482 forks source link

Empty documentation if file is all exports #1237

Open goodmind opened 5 years ago

goodmind commented 5 years ago

Input code

export {combine} from './combine'
export {sample} from './sample'

export type {Domain} from 'effector/domain'
export {createDomain} from 'effector/domain'

export type {Event} from 'effector/event'
export {
  createEvent,
  forward,
  fromObservable,
  chord,
  filter,
} from 'effector/event'

export type {Effect} from 'effector/effect'
export {createEffect} from 'effector/effect'

export type {Store} from 'effector/store'
export {
  createStore,
  createStoreObject,
  setStoreName,
  extract,
  createApi,
  restore,
  restoreEvent,
  restoreEffect,
  restoreObject,
  withProps,
} from 'effector/store'

export {Kind, clearNode, createGraph as createNode, step} from 'effector/stdlib'
export {launch} from 'effector/kernel'
export type {kind} from 'effector/stdlib'

export {
  invariant,
  warning,
  isUnit,
  isStore,
  isEvent,
  isEffect,
  isDomain,
  is,
} from 'effector/validate'
export {version} from 'effector/flags'

//eslint-disable-next-line
export * as blocks from 'effector/blocks'

Output docs

<!-- Generated by documentation.js. Update this documentation by updating the source code. -->

### Table of Contents
tmcw commented 5 years ago

Does this project have any JSDoc annotations, or /** comments at least? Perusing the project, it doesn't look like it has any documentation markup.

goodmind commented 5 years ago

Shouldn't it generate something at least from types?

goodmind commented 5 years ago

I tried --document-exported but it doesn't resolve babel-plugin-module-resolver aliases

Full command

yarn documentation build --babel=./babel.config.js src/effector/index.js -f md -o api_docs --document-exported
goodmind commented 5 years ago

@tmcw any advice?