Fill out the initial contribution guide. Provide templates for PR's and issues.

Author: Mike McGirr

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,29 @@
+---
+name: Bug Report
+about: Report a bug in terraform-aws-foundation
+---
+
+Please follow the steps below for reporting a bug:
+
+Make sure that you are using the latest [release](https://github.com/fpco/terraform-aws-foundation/releases).
+Bugs in a previous release may have been fixed in newer release!
+
+Please use the following schema for your bug report:
+
+### General summary/comments (optional)
+
+### Steps to reproduce
+
+Include any example code to recreate the problem if able to and relevant.
+
+### Expected
+
+What you expected to see and happen.
+
+### Actual
+
+What actually happened.
+
+### Version
+
+Which version where you using when you encountered this bug?

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,9 @@
+---
+name: Feature Request
+about: Request a feature be added to terraform-aws-foundation, or discuss such a feature.
+---
+
+Make sure that you are using the latest [release](https://github.com/fpco/terraform-aws-foundation/releases).
+
+Please state as clearly as possible what feature you are recommending and
+the motivation for why such a feature should be added.

.github/ISSUE_TEMPLATE/question.md

@@ -0,0 +1,19 @@
+---
+name: Question
+about: Ask a question about terraform-aws-foundation usage
+---
+
+
+If you have a question that isn't covered by the 
+[repository examples](https://github.com/fpco/terraform-aws-foundation/tree/master/examples) 
+or the [terraform module documentation](https://registry.terraform.io/modules/fpco) please reach out.
+
+If your question is more generally about any of the tools used in the repository, it is advised to reach 
+out to the relevant help resources for that tool. Your question is more likely to get answered and will have 
+more visibility.
+
+Please make sure that you are using the latest [release](https://github.com/fpco/terraform-aws-foundation/releases).
+
+### terraform-aws-version
+
+### question

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,20 @@
+---
+name: Pull request template
+about: Make a PR to terraform-aws-foundation
+---
+
+Please include the following in your PR:
+
+Please also note that these are not hard requirements, but merely serve to define
+what maintainers are looking for in PR's.  Including these will more likely lead 
+to your PR being reviewed and accepted.
+
+- [ ] Update the changelog
+- [ ] Make sure that modules and files are documented. This can be done inside the module and files.
+- [ ] Make sure that new modules directories contain a basic README.md file.
+- [ ] Make sure that the module is added to [tests/main.tf](https://github.com/fpco/terraform-aws-foundation/blob/master/tests/main.tf)
+- [ ] Make sure that the linting passes on CI.
+- [ ] Make sure that there is an up to date example for your code:
+      - For new `modules` this would entail example code for how to use the module or some explanation in the module readme.
+      - For new examples please provide a README explaining how to run the example. It's also ideal to provide a basic makefile to use the example as well.
+- [ ] Make sure that there is a manual CI trigger that can test the deployment.

CONTRIBUTING.md

@@ -0,0 +1,43 @@
+# Contributing to terraform-aws-foundation
+
+Contributing to terraform-aws-foundation is very welcome. The following are some 
+guidelines and instructions to help those interested. 
+
+These are intended to help you verify that you're submitting well-formed pull 
+requests and opening useful issues for terraform-aws-foundation. Doing so saves 
+the maintainers time by communicating the format that works best and what required
+information and documentation is typically needed.
+
+## Feature requests
+[feature-requests]: #feature-requests
+
+To ask or discuss new features for terraform-aws-foundation, please 
+[open an issue](https://github.com/fpco/terraform-aws-foundation/issues) and use
+the provided feature request template.
+
+## Bug reports and issues
+[bug-reports]: #bug-reports
+
+To report bugs or other issues with terraform-aws-foundation please 
+[open an issue](https://github.com/fpco/terraform-aws-foundation/issues) and use
+the provided template to include all necessary details.
+
+Bugs should not be feature requests in disguise. We're happy to entertain and 
+discuss new feature requests but please use the feature request template for issues.
+
+## Pull Requests
+[pull-requests]: #pull-requests
+
+Please [open a PR](https://github.com/fpco/terraform-aws-foundation/pulls) 
+and follow the provided pull request template as closely as you're able to. 
+
+We tend to use the "fork and pull" model for outside contributors where 
+contributors push changes to their personal fork and then create pull requests
+to bring those changes into the terraform-aws-foundation repository. 
+
+For more information on this using this model please see the Github documentation 
+[here](https://help.github.com/en/articles/about-collaborative-development-models),
+or for more information on how pull requests work on Github please see the documentation
+[here](https://help.github.com/en/articles/about-pull-requests).
+
+Thank you for contributing! 

README.md

@@ -58,3 +58,9 @@ As the collection of modules is composable into an endless array of possibilitie
 there is no explicit requirement to use all of these tools, you can just as easily
 use the IAM management modules and nothing else, or build a more complete stack
 with these modules.
+
+
+## Contributing, Issues, and Feature Requests
+
+Please see [CONTRIBUTING.md](https://github.com/fpco/terraform-aws-foundation/blob/master/CONTRIBUTING.md) for 
+more information.