Documentation
CLI doc
See Usage.
Library doc
The output directory of the library documentation will be docs/yard
.
You can consult it online on GitHub or on RubyDoc.
Building locally: for library users
For developers who only want to use the library.
bundle exec yard doc
Serve locally
Serve with live reload:
bundle exec yard server --reload
Documentation available at: http://localhost:8808/
Publishing
Check the linter:
bundle exec rubocop -a
Update the version in lib/adassault/version.rb
.
Update the documentation, at least:
README.md
to add new featuresdocs/CHANGELOG.md
to document the changesdocs/pages/usage.md
adding examples of usage and explaining why implementing the command was necessary
On new release don't forget to rebuild the library documentation:
bundle exec yard doc
Create an annotated git tag:
git tag -a x.x.x
Push the changes including the tags:
git push --follow-tags
Build the gem:
gem build adassault.gemspec
Push the new gem release on RubyGems. See https://guides.rubygems.org/publishing/.
gem push adassault-x.x.x.gem