A free and open database for farming and gardening knowledge. You can grow anything!
Clone or download
Latest commit 20c0485 Nov 4, 2018
Permalink
Failed to load latest commit information.
app Update deprecated SASS Jun 20, 2018
bin Merge branch 'master' into fix-compatibility-score Feb 23, 2015
config Hound barks May 17, 2018
db Update seeds to make the admin user confirmed Apr 3, 2015
docs Fix formatting Sep 14, 2016
lib Fix: use binomial as common name if common name is missing Oct 18, 2017
public Add middleware to handle bad requests Jul 9, 2016
scripts Moar cleanup Feb 15, 2018
spec Revert spec_helper changes. Nov 4, 2018
test/factories Escape css query in user spec for better parsing. Close #899 Feb 25, 2017
vcr Create a picture mixin to bring all this same code together Dec 10, 2015
vendor De-vendorized assets Sep 1, 2014
.coveralls.yml New badge, added code climate Sep 23, 2014
.dockerignore Update Dockerfile to match OpenFarm changes Mar 3, 2015
.editorconfig 406 added .editorconfig file, 2 spaces for everything except markdown… Jan 13, 2015
.gitignore Enable image uploading on local machines. Close #797 Feb 25, 2017
.hound.yml Point config_file for rubocop Apr 29, 2017
.jshintignore Minor JSHint fixes Sep 28, 2016
.rspec Change RSPec settings Mar 21, 2018
.rubocop.yml Remove reference to non-existent rubocop file Apr 1, 2018
.ruby-gemset Base scaffold for refactored version of OpenFarm Nov 26, 2013
.ruby-version Upgrade to ruby 2.3.3 Jan 14, 2017
.slugignore Remove system public from slugignore Dec 10, 2015
.travis.yml Bump Ruby version in Travis.yml Jun 20, 2018
Dockerfile Moar cleanup Feb 15, 2018
Gemfile Hound violations II Nov 4, 2018
Gemfile.lock Update loofah Nov 4, 2018
LICENSE Update LICENSE Dec 6, 2016
Procfile Using Thin for now Sep 22, 2014
README.md Done. Mar 21, 2018
Rakefile Base scaffold for refactored version of OpenFarm Nov 26, 2013
Vagrantfile [Fix #836] Add installation of vagrant-triggers to Vagrantfile Oct 11, 2016
config.ru Base scaffold for refactored version of OpenFarm Nov 26, 2013
docker-compose.yml Extra `port` option in `dockercompose.yml` Feb 27, 2018
manifest.json Updating Manifest.json: Removing Play app object Aug 15, 2016

README.md

OpenFarm

Coverage Status Code Climate OpenCollective OpenCollective OpenFarm Gitten

Looking for maintainer.

Contact rory@openfarm.cc to find out more, or open an issue to discuss your interest.

Open Source community of contributors: how it works

Shortcuts

Already contributing to OpenFarm? You're welcome to introduce yourself!

Want to dig head first into our todo list of Github tasks? Make yourself at home!

About

OpenFarm is a free and open database and web application for farming and gardening knowledge. One might think of it as the Wikipedia for growing plants, though it functions more like a cooking recipes site.

The main content are Growing Guides: creative, crowd-sourced, single-author, structured documents that include all of the necessary information for a person or machine to grow a plant, i.e.: seed spacing and depth, watering regimen, recommended soil composition and companion plants, sun/shade requirements, etc. In this Freebase platform, gardeners can find answers to questions like “How do I grow tomatoes?”

Start by joining the discussion of existing Contributors

To start the discussion, get involved, and meet OpenFarm core community of contributors, we strongly recommend joining our Slack room! This is where you'll find the latest conversation about Openfarm and the most active contributors.

Check also the FAQ for some frequently asked questions about contributing (Angular, Issue Trackers, IRC Channels).

Check the ongoing issues that need work on in the priority list.

Look for something you want to work on

For front-end and back-end code contributions, we aim at maintaining and prioritizing the Github issues through Github Projects, the Trello-like web-based project management board of Github: OpenFarm Projects.

Need to use OpenFarm Assets? Here they are!

We have few more languages missing for the website content to be translated: help us translate the website!

Who can contribute

Everyone is welcome to bring value to the Open Source community of OpenFarm. Time is our most valuable assets here, so any minute of your time counts to make things happen! "Better done, than perfect!" We strive for diversity in our community and want to ensure we provide a safe and inclusive space for everyone by adopting a Code of Conduct.

Our community is composed of tech and non-tech folks, newbie as well as experts in gardening, overall great people willing to take actions for a better future and sharing knowledge and growing our own food.

Our problem-solving process

On the way we work together, we aim at:

  • having transparency in reasoning behind actions: taking time for documentation, questions and answers
  • prefering done, than perfect: breaking down tasks so that anyone can contribute few min of their time on a regular basis
  • taking shortcuts: what's the most obvious for a better usability? what's the shortest way to build a feature? What's the most valuable inputs for a feedback?

User Flow

Update in progress

Mockups

Update in progress

Development

Getting Started (The Easy Way)

You should use Vagrant to get the OpenFarm system running on your computer. It will avoid having to install the things listed in The Hard Way below.

  1. Install Vagrant.
  2. Install VirtualBox.
  3. Open your terminal.
  4. $ git clone https://github.com/openfarmcc/OpenFarm.git - this tells your computer to fetch the data stored in this repository using git.
  5. $ cd OpenFarm - change to the OpenFarm directory
  6. $ vagrant up This will take a long time. We're downloading a whole bunch of stuff. Go make yourself a pot of coffee, or brew some tea. If something goes wrong at this point, reach out to Simon directly at slack.openfarm.cc.

Accessing Vagrant

Once Vagrant is set up on your system, you might want to actually access it. For example, if you want to start up the server (though vagrant up should run rails s for you):

  1. $ vagrant ssh - this makes you access the new virtual server we just created to run OpenFarm on.
  2. cd /vagrant - the vagrant directory is mirrored in your own computer. If you add a file there, you'll see it appear here.
  3. rails s - actually run the Rails server!
  4. you should now be able to access OpenFarm on your local system at http://localhost:3000. If all went well, you will have a seeded database and can use the account admin@admin.com with password admin123.

The above is still being patched, so please reach out to us if something went wrong!

Getting Started (The Hard Way)

You will need to install Ruby, Rails, ElasticSearch v1.4.5, and Mongodb before you can get an OpenFarm server up and running on your local machine. Once you have these prerequisites to get started with a local copy of the project, run:

$ git clone https://github.com/openfarmcc/OpenFarm.git
$ cd OpenFarm
$ bundle install
$ rake db:setup
$ echo "ENV['SECRET_KEY_BASE'] = '$(rake secret)'" >> config/app_environment_variables.rb
$ echo "ENV['GOOGLE_MAPS_API_KEY'] = ''" >> config/app_environment_variables.rb # or get an actual API key at https://console.developers.google.com/flows/enableapi?apiid=maps_backend&keyType=CLIENT_SIDE&reusekey=true&pli=1
$ rails s

Then, visit http://127.0.0.1:3000/ in your browser to see the OpenFarm web application running on your local machine. If all went well, you will have a seeded database and can use the account admin@admin.com with password admin123.

Note about ElasticSearch: Some Linux users have noted issues installing ElasticSearch onto a host machine. One workaround is to install ElasticSearch via Docker:


sudo docker pull elasticsearch:1.4.5
sudo docker pull mongo
sudo docker run -p 9300:9300 -p 9200:9200 elasticsearch:1.4.5
sudo docker run -p 27017:27017 mongo

If you had any problem installing bundles getting up and running etc see the Common Issues Page.

Remember that /vagrant folder in the Vagrant VM is largely for convenience, and working in it can cause unexpected behavior with other tools - you should do your work in your own non-vagrant environment. Use the environment you're most familiar with to program, and Vagrant will do the rest.

Become a Core Contributors

If you've made two PRs, we'll add you as a core contributor.

For core-code contributors: here are a few basic ground-rules:

  • No --force pushes or modifying the Git history in any way.
  • Non-master branches ought to be used for ongoing work.
  • External API changes and significant modifications ought to be subject to an internal pull-request to solicit feedback from other contributors.
  • Internal pull-requests to solicit feedback are encouraged for any other non-trivial contribution but left to the discretion of the contributor.
  • Contributors should attempt to adhere to the prevailing code-style.

(based on the OPEN open source model)

Further reading

Actual Code Contributors

Here are some of the Github contributors.

Outside of Github, there's a whole host of people who also contributed financially, by building gardening content on the website, on providing more visibility for OpenFarm in any ways!

You've been contributing to OpenFarm already? We invite you to introduce yourself in this 2-min Welcoming Form!

Donate to OpenFarm as a Backer

Support us with a monthly donation and help us continue our activities. [Become a backer]

Support OpenFarm as a Sponsor

Become a sponsor and get your logo on our README on Github with a link to your site. [Become a sponsor]

Software License

The MIT License (MIT)

Copyright (c) 2017 OpenFarm (http://openfarm.cc/).

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Data License

All data within the OpenFarm.cc database is in the Public Domain (CC0).