DocHealth
DocHealth is a Ruby gem that scans a given path for Markdown (.md) files and retrieves the last updated date and author. It provides a terminal readout or exports the results to a CSV file, helping you monitor the health of your documentation.
Installation
Install the gem and add it to your application's Gemfile by executing:
bundle add doc_healthIf bundler is not being used to manage dependencies, install the gem manually:
gem install doc_healthUsage
To scan a directory for Markdown files and display the last modified date and author, run:
doc-health --path /path/to/docsTo output the results to a CSV file:
doc-health --path /path/to/docs --csvDevelopment
After cloning the repository, install dependencies:
bin/setupRun the tests:
rake testUse bin/console for an interactive prompt to experiment with the code.
To install this gem locally:
bundle exec rake installTo release a new version:
- Update the version number in
lib/doc_health/version.rb. - Run:
bundle exec rake releaseThis will create a git tag, push commits and the tag, and publish the gem to RubyGems.
Contributing
Bug reports and pull requests are welcome on GitHub at https://github.com/YOUR_USERNAME/doc_health.