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:

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
    • Add php cs fixer
    • implement usage of template
    • add link to current / latest tag (/latest-release)
      • example link: https://github.com/bazzline/php_component_database_file_storage/releases/tag/0.6.2
    • 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
  • @done
    • Added rector
• 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
  • implemented feature request of issue/2
  • see migration steps
• 1.0.4
  • fixed issue/1
• 1.0.3
  • implemented usage of progress bar component
• 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 :-].