Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
branch: master
Fetching contributors…

Cannot retrieve contributors at this time

251 lines (251 sloc) 9.02 kb
{
"name": "Open Source",
"description": "A software philsophy that promotes free redistribution and access to source code.",
"prerequisites": [
"code-review",
"git",
"refactoring",
"unix",
"vim"
],
"steps": [
{
"name": "Use open source",
"resources": [
{
"title": "Get a GitHub account",
"uri": "http://github.com",
"id": "9a05e7861cea8f094bca4f7059e8d9194b63f6eb"
},
{
"title": "Read about software licenses",
"uri": "http://playbook.thoughtbot.com/choosing-platforms/software-licenses/",
"id": "950ec627aff91aba0615a360b492ef7f44050356"
},
{
"title": "Read about the purpose and formatting of a NEWS file",
"uri": "http://www.gnu.org/prep/standards/html_node/NEWS-File.html#NEWS-File",
"id": "16602739108cdf51374c1a7b5cb334ac6afa1372"
},
{
"title": "Read about the purpose and formatting of a ChangeLog file",
"uri": "http://www.gnu.org/prep/standards/html_node/Change-Logs.html#Change-Logs",
"id": "d1cfd3bed833fc9ba3a3b35a8a9178eab86506c3"
}
],
"validations": [
{
"title": "Evaluate a project based on quality of code, tests, documentation.",
"id": "2cbdf865d70e1a7671c6f0eeb2a74ab43b367d13"
},
{
"title": "Evaluate a project based on responsiveness of maintainers to developers' questions and feature requests.",
"id": "47d93d83192deb579164fd9d8415f3567a664d34"
},
{
"title": "Evaluate a project based on regularity of releases.",
"id": "6fde40031d43ea4a32eb02575fb8600cd3db37bd"
},
{
"title": "Evaluate a project based on the appropriateness of its license for your needs.",
"id": "e2df4db88e03b1a56b0a845adb0806d4b3fdc27f"
},
{
"title": "Evaluate a project by downloading and trying it.",
"id": "c06dbc94f7113647458f9009660ac24b142903b6"
},
{
"title": "Search issues for a similar problem you're having.",
"id": "ec8273ebed502077337ef0f55bb33ab6e7868a2f"
},
{
"title": "Comment with additional data on issues that you're also having.",
"id": "672646b81f5be72b7a72fed9ff39b656bf28067d"
},
{
"title": "Submit new issues with good environment (Ruby version, OS, etc.) info, error messages, and backtraces so the maintainer can quickly replicate it.",
"id": "3b68c192ba34afa6557aad1e6b01d88a9ecda1d4"
}
]
},
{
"name": "Contribute to open source",
"resources": [
{
"title": "Read 8 steps to fixing other people's code",
"uri": "http://rdd.me/tsf7khhg",
"id": "b2160bd4ed120d11722dd99ecf7ee8ccd6aaeef3"
},
{
"title": "Read the Semantic Versioning specification",
"uri": "http://semver.org/",
"id": "a902b96daf1a5bcb9b74b1d0b5ab6bd946e51ebf"
}
],
"validations": [
{
"title": "Get annoyed by a defect or missing feature.",
"id": "def22e80511e9969637f059cfb5756e6e26db68a"
},
{
"title": "Find the source code.",
"id": "b097e52e58794bc5750dc635189d2085d65b5ccb"
},
{
"title": "Create a copy of the source (\"fork\" on Github).",
"id": "e0eba0a8fc17f86b3b738094546e166f79c7ead9"
},
{
"title": "Check out (git clone) the source.",
"id": "caafc364c08bb513e989bf2d000f13d5e462a1cc"
},
{
"title": "Poke around the source in your editor and shell (grep).",
"id": "2fca3aa56db74f490770eb51db4c87d5341d525d"
},
{
"title": "Read the contribution guidelines.",
"id": "c210dfe6a5b7c62bd6ae553d93f54a416338da82"
},
{
"title": "Write a failing test in the style of the project's test suite.",
"id": "bad809d553eeff61ec220d75ea60fb4345c3087f"
},
{
"title": "Write code to make the test pass in the style of the project's codebase.",
"id": "1db29d69f9a8bb7038017079e6eaecc371a8dbcb"
},
{
"title": "Make sure the entire test suite passes.",
"id": "dd584d85a2a6ad5d808aafacf9e523790cacb2b6"
},
{
"title": "Create a patch (push to your fork on Github).",
"id": "fe1921881cfe26320a05d77a99171a24fe795da4"
},
{
"title": "Submit a patch (\"pull request\" on Github).",
"id": "b825eb63a22e925e962b5d302632d5dd299b7b31"
},
{
"title": "If it exists, email the project's mailing list asking for feedback.",
"id": "02b9876b9e8325fb08f904ad87a18be9263adb98"
}
]
},
{
"name": "Maintain an open source project",
"resources": [
{
"title": "Watch How to manage an open source project",
"uri": "http://vimeo.com/45214727",
"id": "7cc3430d61a40a0a497a521e43b3d442e6420fff"
},
{
"title": "Read the rubygems.org \"Make your own gem\" guide",
"uri": "http://guides.rubygems.org/make-your-own-gem/",
"id": "bcc72a29ac5e565010327d3be810138fcd4496b3"
}
],
"validations": [
{
"title": "Apply an appropriate license to your project.",
"id": "8258841bb7a685a33618c0eb6c948ac96df6bf7b"
},
{
"title": "Document a clear public API.",
"id": "0d492ddf97279b50c5e774f291534983463f2208"
},
{
"title": "Document where issues are managed, such as Github Issues.",
"id": "b07a44da91f9cf50b47e06b8f8531e88259065da"
},
{
"title": "Evaluate pull requests and provide kind, intelligent feedback.",
"id": "755056913273bf470e9d569e62f662058efbe0a1"
},
{
"title": "Provide a clear place for questions, such as Stack Overflow. Only provide a Google Group mailing list if you're ready to support it.",
"id": "b078b5d3fa620b9de3d54b23d2ee0dde948072b5"
},
{
"title": "Provide your code in easily accessible form (Rubygems, GitHub).",
"id": "1bed241397360c9ebd86a3c8a0584a5af09f2cfc"
},
{
"title": "Select or reject open source software based on its license.",
"id": "29793685e10a97d26e4ee91e67a7ae68f1b8c2e9"
},
{
"title": "Use major, minor, and patch version numbers (Semantic Versioning).",
"id": "b8ce2254f5f86198d3081719eacd0a31d1a850a2"
}
]
},
{
"name": "Ongoing Reference",
"resources": [
{
"title": "Berkeley DB",
"uri": "http://www.aosabook.org/en/bdb.html",
"id": "94961cf809529c135f53f4425ff8d7ea114a0908"
},
{
"title": "The Bourne-Again Shell",
"uri": "http://www.aosabook.org/en/bash.html",
"id": "b1ac8816cf6434db6e74786bf8cc0d6bebc56f75"
},
{
"title": "Continuous Integration",
"uri": "http://www.aosabook.org/en/integration.html",
"id": "7a302c3f9cf2b3cec42c41ee9b6ddfb04d9516a9"
},
{
"title": "Git",
"uri": "http://www.aosabook.org/en/git.html",
"id": "5819778898df55e3a762f0c5728b457970d72cae"
},
{
"title": "The Glasgow Haskell Compiler",
"uri": "http://www.aosabook.org/en/ghc.html",
"id": "100d90f4f2142237d67f0ffbaff1c9f3e6b733c9"
},
{
"title": "GNU Mailman",
"uri": "http://www.aosabook.org/en/mailman.html",
"id": "7f71aaa7f914352009c39fe7629cf92abf7ff559"
},
{
"title": "MediaWiki",
"uri": "http://www.aosabook.org/en/mediawiki.html",
"id": "429f9802c2088c4c5819bd8664f7ea7bf407e342"
},
{
"title": "nginx",
"uri": "http://www.aosabook.org/en/nginx.html",
"id": "58a3ed6f2965252c6ac4957d95f7a3bdfca47101"
},
{
"title": "Riak and Erlang/OTP",
"uri": "http://www.aosabook.org/en/riak.html",
"id": "27a2696daca52a54823db1caba283146f3207369"
},
{
"title": "Scalable Web Architecture and Distributed Systems",
"uri": "http://www.aosabook.org/en/distsys.html",
"id": "dab68f8e16a8d7888e1b0238bd6ac7e9e68664b9"
},
{
"title": "Sendmail",
"uri": "http://www.aosabook.org/en/sendmail.html",
"id": "5b91012ca70e18d259519cea84a2204f8c4488b8"
},
{
"title": "Twisted",
"uri": "http://www.aosabook.org/en/twisted.html",
"id": "4b79156b13c38a60392112dbdf81a9d0a27fcf63"
}
]
}
]
}
Jump to Line
Something went wrong with that request. Please try again.