0.4.1 • Published 6 years ago

docsense v0.4.1

Weekly downloads
3
License
MIT
Repository
github
Last release
6 years ago

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:


CommandDescription
yarn testRuns all unit tests
yarn buildCompiles source
yarn docsRuns the compiled code against this project
yarn dev-docsWatches 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