timoschilling / hacken-in-website

An event calendar for nerds, geeks & hackers

Welcome

This is the code of hacken.in, an event calendar for geeks in and around Cologne, Berlin and Munich. If you want to help us in extending the calendar to your city, please contact us in our Google Group.

If you find a bug, please report it on our tracker. We discuss features and problems in our Google Group. You can find our backlog here.

Scope of hacken.in

When you want to add an event to hacken.in please check with the following guidelines:

• Currently we only feature events in Ruhr area, Berlin and Munich plus BIG events in Europe
• The following topics are allowed:
  • Programming (in any language)
  • Nerd-Culture (like Star Wars, Ponies, Gaming, Comics...)
  • Software Development Methods and Software Engineering
  • Electronics and Robots
  • Networking

Getting Started

If you want to work on the Project, follow the steps described here:

1. Fork the Project
2. Check out your fork
3. cd into the directory, install the bundler gem and run bundle install
4. Now create a database config: cp config/database.yml_example config/database.yml

• The example config requires MySQL including a database and a user
• More information on the database config

1. Create the Devise & Omniauth configuration cp config/initializers/devise.rb_example config/initializers/devise.rb and edit the keys
2. Now run rake db:migrate to setup your database
3. To run your application locally you can now use rails server
4. Now visit http://localhost:3000 in your webbrowser and you are ready to go!

If you want to add Events to your local page, you need an administrator:

1. Run rake setup:admin
2. Now you can log in with your new administrator ;)

Communication

You can reach us on lots of ways. The most prefered one would be either to open an issue here or to use our Google Group.

Waffle.io

We use waffle.io to manage our tickets. Everyhing in the "ready" state is ready to be implemented.

Localeapp

We use localeapp to translate everything. If you want to play with the code, you can deactivate it by removing the initializer for it in the config/initializer directory.

If we granted you access to localeapp, you will find the api key in the settings of the project.

Pow

Pow is a really comfortable way to run the application on your machine. You can learn everything about it here.

Guard

If you are in the project directory, you can start Guard with guard. This will offer you the following comfortable features:

• Pow: Pow will get restarted automatically when necessary.
• Bundler: Bundler will run, when the Gemfile changes server running
• Specs: If you make changes to a spec or an application file, the according spec will be run and you will get feedback.

Testing

Hacken.in is developed in a test-driven way using Rspec and FactoryGirl. If you want to contribute to the project always add tests for your added functionality. If you find a bug it would be really helpful if you add a regression test that displays this misbehaviour. Even better: Fix it afterwards ;)

Note on Patches/Pull Requests

See CONTRIBUTING.md for details