Skip to content
This repository was archived by the owner on Jul 19, 2025. It is now read-only.

Conversation

maxjacobson
Copy link
Contributor

@maxjacobson maxjacobson commented Sep 28, 2016

  • Document release process
  • update license year
  • pull version from version.rb, set to 1.0.0.rc1
  • Add changelog, document changelog process (modeled after rubocop's
    process)
  • Add a Code of Conduct
  • Move development dependencies to Gemfile
    • I think it's a better practice. The only practical consequence I know of
      is that they don't show up in the dependencies list on rubygems.org,
      otherwise it's basically the same.
  • Change to ruby 2.3.1 for development version
    • 1.9.3 continues to exist in the travis test matrix. We could set a
      minimum ruby version that we want to support, but we're actually using
      1.9.3 ourselves so I think it's good that we're testing there.
  • Specify virtus dependency optimistically
    • Motivated by this warning:

      $ gem build minidoc.gemspec
      WARNING:  pessimistic dependency on virtus (~> 1.0.0) may be overly strict
        if virtus is semantically versioned, use:
          add_runtime_dependency 'virtus', '~> 1.0', '>= 1.0.0'
      WARNING:  See http://guides.rubygems.org/specification-reference/ for help
      
  • Add Code Climate as an author (Following pattern from codeclimate/codeclimate)
  • Flesh out the documentation in the README

I'd like to merge this, and then do a bit of spit-and-polish on the README (feel free to help) and, I think, improve the first-run experience so users can get a better error if they try to use Minidoc before setting a connection or database_name, and then release this as v1.0.0.rc1, update our services, and if everything goes well, release it as v1.0.0.

WDYT?

@maxjacobson maxjacobson force-pushed the mj-prep-for-gem-release branch from df9a553 to cb59deb Compare September 28, 2016 19:53
@maxjacobson
Copy link
Contributor Author

@codeclimate/review finished fleshing out the documentation in the README. Ready for a look 👀


[@nporteschaikin]: https://github.com/nporteschaikin
[@pbrisbin]: https://github.com/pbrisbin
[@wfleming]: https://github.com/wfleming
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

should bryan be here?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I was thinking about fleshing out the bottom of the changelog and I can mention Bryan there. This section of the changelog can grow as needed, as people's names are referenced above (this is a weird markdown syntax where you make a hyperlink at the top and look up the address at the bottom by name, and we don't currently mention Bryan, so he doesn't show up)

when an individual is representing the project or its community.

Instances of abusive, harassing, or otherwise unacceptable behavior may be
reported by contacting a project maintainer at max@hardscrabble.net. All
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

thank you :)

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

heh wait good catch I copied this from another project but I'd like to change this to hello@codeclimate.com

* Document release process
* update license year
* pull version from version.rb, set to 1.0.0.rc1
* Add changelog, document changelog process (modeled after rubocop's
  process)
* Add a Code of Conduct
* Move development dependencies to Gemfile
  * I think it's a better practice. The only practical consequence I know of
    is that they don't show up in the dependencies list on rubygems.org,
    otherwise it's basically the same.
* Change to ruby 2.3.1 for development version
  * 1.9.3 continues to exist in the travis test matrix. We could set a
    minimum ruby version that we want to support, but we're actually using
    1.9.3 ourselves so I think it's good that we're testing there.
* Specify virtus dependency optimistically
  * Motivated by this warning:

      ```
      $ gem build minidoc.gemspec
      WARNING:  pessimistic dependency on virtus (~> 1.0.0) may be overly strict
        if virtus is semantically versioned, use:
          add_runtime_dependency 'virtus', '~> 1.0', '>= 1.0.0'
      WARNING:  See http://guides.rubygems.org/specification-reference/ for help
      ```
* Add Code Climate as an author (Following pattern from codeclimate/codeclimate)
* Flesh out the documentation in the README
@maxjacobson maxjacobson force-pushed the mj-prep-for-gem-release branch from cb59deb to b5a151c Compare September 28, 2016 21:26
@maxjacobson maxjacobson merged commit 8c11bdb into master Sep 28, 2016
@maxjacobson maxjacobson deleted the mj-prep-for-gem-release branch September 28, 2016 21:31
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Suggestion for releasing as a gem
2 participants