docsense
An Intelligent Doc Generator tailored for EcmaScript Modules
Last updated 2 years ago by mattmcfarland .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install docsense 
SYNC missed versions from official npm registry.

Docsense

Docsense is a pluggable and customizable AST to documentation generator which parses ECMASCIPT 2015+ using Babylon,

???? **It is still in early development, but operational! ** ????

Quick start

# Add with yarn
yarn add docsense
# Run init to create the default config file
yarn docsense init
# Run build to see your docs!
yarn docsense build

More info about CLI

Development

:muscle: Clone the project, then run yarn to install all dependencies.

git clone https://github.com/MattMcFarland/docsense
yarn

Scripts

There are a number of scripts that may be run using yarn - the ones that should work independent of developer environments are as follows:


Command Description
yarn test Runs all unit tests
yarn build Compiles source
yarn docs Runs the compiled code against this project
yarn dev-docs Watches src/generator for changes, building the new documentation on changes. This will not work unless docs have already been built first.

Debugging

This project may be debugged with VSCode, and has not been tested with other IDEs. You can set breakpoints within the source code, press F5 and run. The debug mode will basically run docs against this project, generating the db.json (and eventually the docs) as if you were to run docsense against this project in production.

Architecture

Docsense will eventualy run in the command line against the process.cwd() of the project a user has it installed in as a module. As of now, it only runs against this project, parsing all of the code, then creating a database which may be queried by the document generator. The document generator is currently unfinished, so after running yarn docs - you may run yarn dev-docs which will runs a local server that hosts the generated documentation, updating automatically as you make changes to the generator scripts found in src/generator

Execution ->
  Read .docsenserc Config ->
    Generate AST ->
      Execute all plugins ->
        Plugin visitors create a database ->
          Static Docs are generated

LICENSE

MIT

Current Tags

  • 0.4.1                                ...           latest (2 years ago)

12 Versions

  • 0.4.1                                ...           2 years ago
  • 0.4.0                                ...           2 years ago
  • 0.3.6                                ...           2 years ago
  • 0.3.5                                ...           2 years ago
  • 0.3.4                                ...           2 years ago
  • 0.3.3                                ...           2 years ago
  • 0.3.1                                ...           2 years ago
  • 0.3.0                                ...           2 years ago
  • 0.2.0                                ...           2 years ago
  • 0.1.0                                ...           2 years ago
  • 0.0.1                                ...           2 years ago
  • 0.0.0-1                                ...           2 years ago
Maintainers (1)
Downloads
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 0
Last Month 0
Dependencies (32)
Dev Dependencies (41)
Dependents (0)
None

Copyright 2014 - 2016 © taobao.org |