Sha256: cccb03fe6ccc0a6297ddba426ad9f26144cc7de9558a3d5dd3887b35bd4be1d7

Contents?: true

Size: 1.61 KB

Versions: 24

Compression:

Stored size: 1.61 KB

Contents

# Contributing

## Add new resource type (ex. Redshift resource)

1. Create your feature branch (`git checkout -b add-type-redshift`)
2. Generate template files (`bundle exec bin/toolbox template redshift`)
3. Fill files with code.
4. `bundle update` to update gems.
5. Generate [doc/resource_types.md](doc/resource_types.md) (`bundle exec bin/toolbox docgen > doc/resource_types.md`)
6. Run test (`bundle exec rake spec`)
7. Push to the branch (`git push origin add-type-redshift`)
8. Create a new Pull Request

### Troubleshooting

#### CI Failed 'Awspec::Generator::Doc::Type generate_doc output should be the same as doc/resource_types.md'

Maybe, your `aws-sdk-ruby` is not latest. Please exec `bundle update` and `bundle exec bin/toolbox docgen > doc/resource_types.md`.

( `aws-sdk-ruby` is often updated. )

## Add new account attribute type (ex. CloudFormation::Client#describe_account_attributes )

1. Create your feature branch (`git checkout -b add-type-cf-limit`)
2. Generate template files (`bundle exec bin/toolbox template cloudformation_account_attributes -a`) **with -a option**
3. Fill files with code.
4. Generate [doc/resource_types.md](doc/resource_types.md) (`bundle exec bin/toolbox docgen > doc/resource_types.md`)
5. Run test (`bundle exec rake spec`)
6. Push to the branch (`git push origin add-type-cf-limit`)
7. Create a new Pull Request

## Append resource type document (ex. VPC resource `be_available`)

1. Create vpc.md (`touch doc/_resource_types/vpc.md`)
2. Write following document.

<pre>
### be_available
(Write cool description)
```ruby
describe vpc('my-vpc') do
   it { should be_available }
end
```
</pre>

Version data entries

24 entries across 24 versions & 1 rubygems

Version Path
awspec-1.18.1 doc/contributing.md
awspec-1.18.0 doc/contributing.md
awspec-1.17.4 doc/contributing.md
awspec-1.17.3 doc/contributing.md
awspec-1.17.2 doc/contributing.md
awspec-1.17.1 doc/contributing.md
awspec-1.17.0 doc/contributing.md
awspec-1.16.1 doc/contributing.md
awspec-1.16.0 doc/contributing.md
awspec-1.15.3 doc/contributing.md
awspec-1.15.2 doc/contributing.md
awspec-1.15.1 doc/contributing.md
awspec-1.15.0 doc/contributing.md
awspec-1.14.1 doc/contributing.md
awspec-1.14.0 doc/contributing.md
awspec-1.13.0 doc/contributing.md
awspec-1.12.7 doc/contributing.md
awspec-1.12.6 doc/contributing.md
awspec-1.12.5 doc/contributing.md
awspec-1.12.4 doc/contributing.md