Skip to content

Wildhoney/G-Man

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

25 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

G-Man

Travis   npm

  • npm: npm install gman -g

G-Man is a documentation engine which uses GitHub.com as the doc source, and parses Markdown documents to provide an easy way for developers to read documentation. All of the options in G-Man can be configured with the .gman.yml configuration.

G-Man and Cat
Source: ViaEstelar on DeviantArt.com.


Getting Started

G-Man follows a format that allows a readable format in both GitHub and the CLI. By following the standards your output will look something similar to the following

G-Man Screenshot v0.1.0

Please follow the example for the G-Man documentation in creating your own documentation files.

When the developer types gman in the root of your application, G-Man will cleverly find all of your documentation files and enumerate them to the developer. Developers can also perform searches on your G-Man documentation – all from the command prompt, and without you having to do anything special!

Searching Documentation

As a developer you're likely to want information on a given method. Using G-Man you can locate the documentation for a function by specifying the gman -f methodName command – where methodName is the function you would like further information about. G-Man will iterate over the documentation to discover the files which contain your desired method – if only one file has the method then that is output, otherwise you'll be given a choice.

YAML Configuration

Using the .gman.yaml file you can modify default G-Man parameters.

Currently G-Man supports the directory property which you can modify to alter the documentation location.

Configuration parameters are specified in the traditional YAML way:

directory: documentation

About

G-Man is a documentation engine which uses GitHub.com as the doc source, and parses Markdown documents to provide an easy way for developers to read documentation.

Resources

Stars

Watchers

Forks

Packages

No packages published