Installs: 6 998
Open Issues: 9
- hhvm: ^4.102
- facebook/definition-finder: ^2.13.0
- facebook/fbmarkdown: ^1.6.5
- facebook/hh-clilib: ^2.1.0
- hhvm/hhast: ^4.80
- hhvm/hsl: ^4.0
- hhvm/hsl-experimental: ^4.53
- hhvm/hsl-io: ^0.2.1|^0.3
- hhvm/hhvm-autoload: ^2.0|^3.0
An API documentation generator for Hack files. The generator works on files that start with
HHAPIDoc generates its own API reference documentation.
This is derived from docs.hhvm.com's documentation generator, and has been in use there for several months.
As a standalone project, it is immature, and an early preview; work is needed on output format (prettiness), usability, and functionality. See the issues to get started. We welcome contributions.
- Install hhvm
- Install composer
composer.pharto your desired location. Many people put this in their home directory or a global
- Clone this repo
hhvm path/to/composer.phar install
- Verify installation via
hhvm bin/hh-apidoc --help. You should see usage instructions.
hh-apidoc against itself is a good way to test the generator:
hhvm bin/hh-apidoc -o /tmp/docs ./srcThe
-ois where to output the resulting files (it is important to note that the path given to
-omust currently be an existing path).
.means use the current directory as the source.
- See generated
.htmlfiles. You can open
index.htmlin your favorite browser to see the generated documentation.
hh-apidoc is MIT licensed, as found in the LICENSE file.