Start of contributing doc.

Author: myronmarston

Rakefile

@@ -4,6 +4,7 @@ require 'pathname'
 require 'bundler'
 require 'time'
 require 'date'
+require 'erb'
 
 Projects = ['rspec', 'rspec-core', 'rspec-expectations', 'rspec-mocks', 'rspec-rails', 'rspec-support']
 UnDocumentedProjects = %w[ rspec rspec-support ]
@@ -287,23 +288,25 @@ end
 namespace :common_markdown_files do
   def update_common_markdown_files_in_repos
     update_files_in_repos('common markdown files', ' [ci skip]') do |name|
-      common_markdown_files_with_comments.each do |file|
+      common_markdown_files_with_comments(name).each do |file|
         full_file_name = ReposPath.join(name, file.file_name)
         full_file_name.write(file.contents)
         full_file_name.chmod(file.mode) # ensure executables are set
       end
     end
   end
 
-  def common_markdown_files_with_comments
+  def common_markdown_files_with_comments(project_name)
     markdown_root = BaseRspecPath.join('common_markdown_files')
     file_names = Pathname.glob(markdown_root.join('**', '{*,.*}')).select do |f|
       f.file?
     end
 
     file_names.map do |file|
       comments_added = false
-      lines = file.each_line.each_with_object([]) do |line, all|
+      content = markdown_file_content(file, project_name)
+
+      lines = content.each_line.each_with_object([]) do |line, all|
         if !comments_added && !line.start_with?('#!')
           all.concat([
             "<!---\n",
@@ -318,13 +321,26 @@ namespace :common_markdown_files do
       end
 
       ReadFile.new(
-        file.relative_path_from(markdown_root),
+        file.relative_path_from(markdown_root).sub(/\.erb$/, ''),
         lines.join,
         file.stat.mode
       )
     end
   end
 
+  ERBRenderer = Struct.new(:project_name, :contents) do
+    def render
+      # Our `binding` makes `project_name` available to the ERB template.
+      ERB.new(contents).result(binding)
+    end
+  end
+
+  def markdown_file_content(file, project_name)
+    raw_contents = file.read
+    return raw_contents unless file.extname == ".erb"
+    ERBRenderer.new(project_name, raw_contents).render
+  end
+
   desc "Update common markdown files"
   task :update_files do
     update_common_markdown_files_in_repos

common_markdown_files/CONTRIBUTING.md.erb

@@ -0,0 +1,20 @@
+# Contributing
+
+RSpec is a community-driven project that has benefited from improvements from over over *500* contributors.
+We welcome contributions from *everyone*. While contributing, please follow the project [code of conduct](../code_of_conduct.md), so that everyone can be included.
+
+If you'd like to help make RSpec better, here are some ways you can contribute:
+
+  - by running RSpec HEAD to help us catch bugs before new releases
+  - by [reporting bugs you encounter](https://github.com/rspec/<%= project_name %>/issues/new)
+  - by [suggesting new features](https://github.com/rspec/<%= project_name %>/issues/new)
+  - by improving RSpec's [Relish](https://relishapp.com/rspec) or [API](http://rspec.info/documentation/) documentation
+  - by improving [RSpec's website](http://rspec.info/) ([source](https://github.com/rspec/rspec.github.io))
+  - by taking part in [feature and issue discussions](https://github.com/rspec/<%= project_name %>/issues)
+  - by adding a failing test for reproducible [reported bugs](https://github.com/rspec/<%= project_name %>/issues)
+  - by reviewing [pull requests](https://github.com/rspec/<%= project_name %>/pulls) and suggesting improvements
+  - by [writing code](../DEVELOPMENT.md) (no patch is too small! fix typos or bad whitespace)
+
+If you need help getting started, check out the [DEVELOPMENT](../DEVELOPMENT.md) file for steps that will get you up and running.
+
+Thanks for helping us make RSpec better!