From 522b27d481709abc207d8fdab836057192e6af38 Mon Sep 17 00:00:00 2001 From: Tim Smith Date: Thu, 22 Sep 2016 14:45:14 -0700 Subject: Move contributing docs to chef/chef and format MD Signed-off-by: Tim Smith --- README.md | 84 +++++++++++++++++++++++++++------------------------------------ 1 file changed, 36 insertions(+), 48 deletions(-) (limited to 'README.md') diff --git a/README.md b/README.md index 3ca689df..626f596e 100644 --- a/README.md +++ b/README.md @@ -1,84 +1,72 @@ # ohai -[![Build Status Master](https://travis-ci.org/chef/ohai.svg?branch=master)](https://travis-ci.org/chef/ohai) -[![Build Status Master](https://ci.appveyor.com/api/projects/status/github/chef/ohai?branch=master&svg=true&passingText=master%20-%20Ok&pendingText=master%20-%20Pending&failingText=master%20-%20Failing)](https://ci.appveyor.com/project/Chef/ohai/branch/master) -[![Gem Version](https://badge.fury.io/rb/ohai.svg)](https://badge.fury.io/rb/ohai) +[![Build Status Master](https://travis-ci.org/chef/ohai.svg?branch=master)](https://travis-ci.org/chef/ohai) [![Build Status Master](https://ci.appveyor.com/api/projects/status/github/chef/ohai?branch=master&svg=true&passingText=master%20-%20Ok&pendingText=master%20-%20Pending&failingText=master%20-%20Failing)](https://ci.appveyor.com/project/Chef/ohai/branch/master) [![Gem Version](https://badge.fury.io/rb/ohai.svg)](https://badge.fury.io/rb/ohai) -# DESCRIPTION: +## Description -Ohai detects data about your operating system. It can be used -standalone, but its primary purpose is to provide node data to Chef. +Ohai detects data about your operating system. It can be used standalone, but its primary purpose is to provide node data to Chef. -Ohai will print out a JSON data blob for all the known data about your -system. When used with Chef, that data is reported back via node -attributes. +Ohai will print out a JSON data blob for all the known data about your system. When used with Chef, that data is reported back via node attributes. -Chef distributes ohai as a RubyGem. This README is for developers who -want to modify the Ohai source code. For users who want to write plugins -for Ohai, see the docs: +Chef distributes ohai as a RubyGem. This README is for developers who want to modify the Ohai source code. For users who want to write plugins for Ohai, see the docs: -* General documentation: https://docs.chef.io/ohai.html -* Custom plugin documentation: https://docs.chef.io/ohai_custom.html +- General documentation: +- Custom plugin documentation: -# DEVELOPMENT: +## Development Environment: -Before working on the code, if you plan to contribute your changes, you -should read the contributing guidelines: - -* https://github.com/chef/ohai/blob/master/CONTRIBUTING.md - -The basic process for contributing is: - -1. Fork this repo on GitHub. -2. Create a feature branch for your work. -3. Make your change, including tests. -4. Submit a pull request. - -# ENVIRONMENT: - -Ohai's development dependencies should be installed with bundler. Just -run `bundle install` in the root of the repo. +Ohai's development dependencies should be installed with bundler. Just run `bundle install` in the root of the repo. ## Spec Testing: We use RSpec for unit/spec tests. To run the full suite, run: - bundle exec rake spec +``` +bundle exec rake spec +``` You can run individual test files by running the rspec executable: - bundle exec rspec spec/unit/FILE.rb +``` +bundle exec rspec spec/unit/FILE.rb +``` ## Rake Tasks Ohai has some Rake tasks for doing various things. - rake -T - rake build # Build the gem file ohai-$VERSION.gem - rake install # install the gem locally - rake install:local # install the gem locally without network access - rake release # Create tag $VERSION, build gem, and push to Rubygems - rake spec # Run RSpec tests - - ($VERSION is the current version, from the GemSpec in Rakefile) +``` +rake -T +rake build # Build the gem file ohai-$VERSION.gem +rake install # install the gem locally +rake install:local # install the gem locally without network access +rake release # Create tag $VERSION, build gem, and push to Rubygems +rake spec # Run RSpec tests + +($VERSION is the current version, from the GemSpec in Rakefile) +``` -# LINKS: +## Links: Source: -* https://github.com/chef/ohai/tree/master +- Issues: -* https://github.com/chef/ohai/issues +- + +## Contributing + +For information on contributing to this project see -# LICENSE: +## License Ohai - system information application -* Author:: Adam Jacob () -* Copyright:: Copyright (c) 2008-2016 Chef Software, Inc. -* License:: Apache License, Version 2.0 +- Author:: Adam Jacob ([adam@chef.io](mailto:adam@chef.io)) +- Copyright:: Copyright (c) 2008-2016 Chef Software, Inc. +- License:: Apache License, Version 2.0 ```text Licensed under the Apache License, Version 2.0 (the "License"); -- cgit v1.2.1