free as in freedom centralize api documentation generation and updating of existing projects
PHP HTML
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
bin
configuration
example
migration
source
.gitignore
LICENSE
README.md
composer.json

README.md

Api Document Builder

Api document builder centralize api documentation generation and updating of existing projects. Use it as a cronjob to have the latest documentation in time. Available at packagist and openhub.net.

The versioneye status is: Dependency Status

Work Flow

  • iterating over collection of project paths
  • generates documentation using apigen
  • creates index.html
  • do a git pull and evaluates the output to check if there is work to do

Usage

./bin/net_bazzline_api_document_builder path/to/configuration.php

Example

mkdir -p net_bazzline/api_document_builder
cd net_bazzline/api_document_builder
git clone https://github.com/bazzline/api_document_builder/ .
./bin/net_bazzline_api_document_builder example/configuration.php
lynx example/output/index.html

History

  • upcomming
    • @todo
      • implement usage of template
      • add link to current / latest tag (/latest-release)
      • add links for each tag/release
      • add optional link to "demo page"
      • refactor by using the process pipe component
      • refactor by using the requirement component
      • implement unit tests
      • make it dynamically
        • use diactoros
        • generate a index.php instead of a index.html
        • add htaccess
        • /my_project should be callable and transform into a redirect (if exists)
      • easy up adding project
        • parse composer.json
      • easy up deleting project
        • deletes all where response code is greater or equal 300
      • add more documentation generators (beside apigen)
      • create factories
      • add "keep_cache" (boolean) value
      • implement cache and output cleanup (if project is moved or deleted etc.)
        • validate git pull return message
      • supporting multiple project tags
  • 1.3.0 - released at 23.10.2016
    • releaxed dependency handling by using the asterix on the bug level version
  • 1.2.2 - released at 15.03.2016
    • updated dependencies
  • 1.2.1 - released at 29.02.2016
    • fixed broken image for version eye
    • updated dependency
  • 1.2.0 - released at 29.02.2016
    • moved to psr-4 autoloading
  • 1.1.9 - released at 24.01.2016
    • updated dependency
  • 1.1.8 - released at 18.12.2015
    • updated dependency
  • 1.1.7 - released at 19.11.2015
    • updated dependency
  • 1.1.6 - released at 14.11.2015
    • updated dependency
  • 1.1.5 - released at 08.11.2015
    • updated dependency
  • 1.1.4 - released at 25.09.2015
    • updated dependency
  • 1.1.3 - released at 18.09.2015
    • updated dependency
  • 1.1.2 - released at 13.09.2015
    • updated dependency
  • 1.1.1 - released at 04.07.2015
    • updated dependency
  • 1.1.0
  • 1.0.4
  • 1.0.3
  • 1.0.2
    • added optional "tracking_snippet" support for configuration
    • made index.html valid
  • 1.0.1
    • updated dependency
  • 1.0.0
    • initial release

Final Words

Star it if you like it :-). Add issues if you need it. Pull patches if you enjoy it. Write a blog entry if you use it. Donate something if you love it :-].