🚨 WORK IN PROGRESS

Project Documentation Generator

• What is Assemble?
• Usage
• Commands

Assemble is a single-purpose tool meant to solve common documentation problems for project contributors.

Imagine that you are brand new to a project. You clone the repository and open the README.md file to get started. You then want to update some code that looks quite complex, and you wonder if there is some documentation for it. Where do you look? If you're lucky, the documentation exists but it's in another app. Not only is the documentation hard to find, but it also makes it hard for developers to update that documentation.

This is where Assemble comes in. It reduces the obstacle of writing documentation by enabling developers to write it in Markdown files right next to where their code is. Here is an example file structure:

.
├── features/
│   └── auth/
│       ├── index.js
│       └── readme.md
└── readme.md

Assemble would build a site with two pages:

• Main Readme
• Auth Readme

The site can then easily be deployed to any static site host such as GitHub Pages from the same project repository to ensure that documentation stays in sync. This enables existing contributors to code and document at the same time, while also empowering newcomers to browse through the documentation site to learn about the codebase.

$ npm install -g @assembledocs/cli
$ assemble COMMAND
running command...
$ assemble (-v|--version|version)
@assembledocs/cli/0.0.0 darwin-x64 node-v14.15.5
$ assemble --help [COMMAND]
USAGE
  $ assemble COMMAND
...

• assemble build [PATH]
• assemble help [COMMAND]

build static site

USAGE
  $ assemble build [PATH]

OPTIONS
  -h, --help           show CLI help
  --distPath=distPath  [default: .assembledocs/dist]

See code: src/commands/build.ts

display help for assemble

USAGE
  $ assemble help [COMMAND]

ARGUMENTS
  COMMAND  command to show help for

OPTIONS
  --all  see all commands in CLI

See code: @oclif/plugin-help