objective-php/docu-mentor

Tool to generate Objective-php's markdown documentation

ObjectivePHP \ DocuMentor

Introduction

We always wanted to make our framework Objective PHP serviceable for every person who get interested getting an use of it. We tried to write documentation in many ways but we choose to write a tool to generate a custom markdown documentation for every components., _(*1)

Description

Docu-mentor is a CLI tool for the documentation generation for packages., _(*2)

## Installation, _(*3)

### Composer, _(*4)

The easiest way to install the library and get ready to play with it is by using Composer. Run the following command :, _(*5)

composer require objective-php/docu-mentor The command will be accessible in ./vendor/bin, _(*6)

Configuration directive documentation guides

For : - Scalar - Complex - Example-Values, _(*7)

How to use

Usage

php docu [OPTIONS]    

    -i, --init      Generate the docs/.md files 
    -c, --configs   Update the config-directive doc file
    -v, --verbose   Shows the errors
    -vv, -vvv       Shows the errors more expressly
    -f, --force     Overwrite the docs
    -h,-u, --help,--usage   
                    Show this message
     --config-dir=[path]
                    Specify a custom path for the configs   
     --docs-dir=[path]   
                    Specify a custom path for output directory
     --composer-file=[path]   
                    Specify a custom path for composer.json   
 ```                 

### Examples:
Init the whole documentation:
``` bash
    php docu -ic

Rewrite the config doc: ``` bash php docu -c -v, _(*8)

Rewrite and debug your config:
``` bash
    php docu -c -vvv

Reset the docs: ``` bash php docu -i --force, _(*9)

Custom pathes:
``` bash
    php docu -ic --config-dir=./docs/ --docs-dir=./Config  

The whole documentation

Full documentation can be found at objective-php.org, _(*10)