Generate a text version of MAINTAINERS

6 files changed, 203 insertions, 0 deletions

diff --git a/.gitignore b/.gitignore
index 6588499305..39962d2f5f 100644
--- a/.gitignore
+++ b/.gitignore
@@ -2,6 +2,7 @@
 coverage
 .DS_Store
 pkg
+tags
 */tags
 *~
 
diff --git a/Gemfile b/Gemfile
index d3da2919da..c5b0f15bc3 100644
--- a/Gemfile
+++ b/Gemfile
@@ -6,6 +6,7 @@ gem "activesupport", "< 4.0.0", :group => :compat_testing, :platform => "ruby"
 gem 'chef-config', path: "chef-config"
 
 group(:docgen) do
+  gem "tomlrb"
   gem "yard"
 end
 
diff --git a/MAINTAINERS.md b/MAINTAINERS.md
new file mode 100644
index 0000000000..6318b50ce7
--- /dev/null
+++ b/MAINTAINERS.md
@@ -0,0 +1,131 @@
+<!-- This is a generated file. Please do not edit directly -->
+
+# Maintainers
+
+This file lists how the Chef project is maintained. When making changes to the system, this
+file tells you who needs to review your patch - you need a simple majority of maintainers
+for the relevant subsystems to provide a :+1: on your pull request. Additionally, you need
+to not receive a veto from a Lieutenant or the Project Lead.
+
+Check out [How Chef is Maintained](https://github.com/opscode/chef-rfc/blob/master/rfc030-maintenance-policy.md#how-the-project-is-maintained) for details on the process, how to become
+a maintainer, lieutenant, or the project lead.
+
+# Project Lead
+
+* [Adam Jacob](https://github.com/adamhjk)
+
+## Components
+
+## Chef Core
+
+Handles the core parts of the Chef DSL, base resource and provider
+infrastructure, and the Chef applications. Includes anything not covered by
+another component.
+
+### Lieutenant
+
+* [Thom May](https://github.com/thommay)
+
+### Maintainers
+
+* [Bryan McLellan](https://github.com/btm)
+* [Daniel DeLeo](https://github.com/danielsdeleo)
+* [AJ Christensen](https://github.com/fujin)
+* [Phil Dibowitz](https://github.com/jaymzh)
+* [Jay Mundrawala](https://github.com/jdmundrawala)
+* [Jon Cowie](https://github.com/jonlives)
+* [Lamont Granquist](https://github.com/lamont-granquist)
+* [Steven Murawski](https://github.com/smurawski)
+* [Tyler Ball](https://github.com/tyler-ball)
+* [Ranjib Dey](https://github.com/ranjib)
+
+## Dev Tools
+
+Chef Zero, Knife, Chef Apply and Chef Shell.
+### Maintainers
+
+* [Daniel DeLeo](https://github.com/danielsdeleo)
+* [Joshua Timberman](https://github.com/jtimberman)
+* [Lamont Granquist](https://github.com/lamont-granquist)
+* [Steven Danna](https://github.com/stevendanna)
+
+## Test Tools
+
+ChefSpec
+### Lieutenant
+
+* [Seth Vargo](https://github.com/sethvargo)
+
+### Maintainers
+
+* [Joshua Timberman](https://github.com/jtimberman)
+* [Lamont Granquist](https://github.com/lamont-granquist)
+* [Ranjib Dey](https://github.com/ranjib)
+
+## Platform Specific Components
+
+The specific components of Chef related to a given platform - including (but not limited to) resources, providers, and the core DSL.
+
+## Enterprise Linux
+
+### Lieutenant
+
+* [Jon Cowie](https://github.com/jonlives)
+
+### Maintainers
+
+* [Phil Dibowitz](https://github.com/jaymzh)
+* [Lamont Granquist](https://github.com/lamont-granquist)
+
+## Ubuntu
+
+### Maintainers
+
+* [Lamont Granquist](https://github.com/lamont-granquist)
+* [Ranjib Dey](https://github.com/ranjib)
+* [Thom May](https://github.com/thommay)
+
+## Windows
+
+### Lieutenant
+
+* [Bryan McLellan](https://github.com/btm)
+
+### Maintainers
+
+* [Jay Mundrawala](https://github.com/jdmundrawala)
+* [Steven Murawski](https://github.com/smurawski)
+
+## Solaris
+
+### Maintainers
+
+* [Lamont Granquist](https://github.com/lamont-granquist)
+
+## AIX
+
+### Maintainers
+
+* [Lamont Granquist](https://github.com/lamont-granquist)
+
+## Mac OS X
+
+### Lieutenant
+
+* [Joshua Timberman](https://github.com/jtimberman)
+
+### Maintainers
+
+* [Tyler Ball](https://github.com/tyler-ball)
+
+## FreeBSD
+
+### Lieutenant
+
+* [Aaron Kalin](https://github.com/martinisoft)
+
+### Maintainers
+
+* [Cory Stephenson](https://github.com/Aevin1387)
+* [David Aronsohn](https://github.com/tbunnyman)
+
diff --git a/MAINTAINERS.toml b/MAINTAINERS.toml
index d337e9cec8..f949fd4542 100644
--- a/MAINTAINERS.toml
+++ b/MAINTAINERS.toml
@@ -20,6 +20,8 @@ a maintainer, lieutenant, or the project lead.
     person = "adamhjk"
 
   [Org.Components]
+    title = "Components"
+
     [Org.Components.Core]
       title = "Chef Core"
       text = """
diff --git a/Rakefile b/Rakefile
index 6a6e163a53..628e0e1d45 100644
--- a/Rakefile
+++ b/Rakefile
@@ -24,6 +24,7 @@ require 'rubygems/package_task'
 require 'rdoc/task'
 require_relative 'tasks/rspec'
 require_relative 'tasks/external_tests'
+require_relative 'tasks/maintainers'
 
 GEM_NAME = "chef"
 
diff --git a/tasks/maintainers.rb b/tasks/maintainers.rb
new file mode 100644
index 0000000000..b3ab08c577
--- /dev/null
+++ b/tasks/maintainers.rb
@@ -0,0 +1,67 @@
+#
+# Author:: Adam Jacob (<adam@opscode.com>)
+# Author:: Daniel DeLeo (<dan@opscode.com>)
+# Copyright:: Copyright (c) 2008, 2010 Opscode, Inc.
+# License:: Apache License, Version 2.0
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+require 'rake'
+require 'tomlrb'
+
+SOURCE = File.join(File.dirname(__FILE__), "..", "MAINTAINERS.toml")
+TARGET = File.join(File.dirname(__FILE__), "..", "MAINTAINERS.md")
+
+task :default => :generate
+
+namespace :maintainers do
+  desc "Generate MarkDown version of MAINTAINERS file"
+  task :generate do
+    maintainers = Tomlrb.load_file SOURCE
+    out = "<!-- This is a generated file. Please do not edit directly -->\n\n"
+    out << "# " + maintainers["Preamble"]["title"] + "\n\n"
+    out <<  maintainers["Preamble"]["text"] + "\n"
+    out << "# " + maintainers["Org"]["Lead"]["title"] + "\n\n"
+    out << person(maintainers["people"], maintainers["Org"]["Lead"]["person"]) + "\n\n"
+    out << components(maintainers["people"], maintainers["Org"]["Components"])
+    File.open(TARGET, "w") { |fn|
+      fn.write out
+    }
+  end
+end
+
+def components(list, cmp)
+  out = "## " + cmp.delete("title") + "\n\n"
+  out << cmp.delete("text") + "\n" if cmp.has_key?("text")
+  if cmp.has_key?("lieutenant")
+    out << "### Lieutenant\n\n"
+    out << person(list, cmp.delete("lieutenant")) + "\n\n"
+  end
+  out << maintainers(list, cmp.delete("maintainers")) + "\n" if cmp.has_key?("maintainers")
+  cmp.delete("paths")
+  cmp.each {|k,v| out << components(list, v) }
+  out
+end
+
+def maintainers(list, people)
+  o = "### Maintainers\n\n"
+  people.each do |p|
+    o << person(list, p) + "\n"
+  end
+  o
+end
+
+def person(list, person)
+  "* [#{list[person]["Name"]}](https://github.com/#{list[person]["GitHub"]})"
+end