docworld / amsterdamphp.nl

The website fo the AmsterdamPHP User Group

amsterdamphp.nl

This repository hosts the main AmsterdamPHP Website. The purpose of this website is to showcase the User Group, from the work that is done and its results to the sponsors who allow us to make this happen and the people who contribute to allow us to accomplish so much.

Its a community project, lead by the organisers and executed by the members. All communication for this project is done either in the issues page, or in the enablers mailing list.

Want to contribute?

We want this to be a community project we all rally behind and keep up to date, but we also want it to be a learning experience. This means experimenting with new technologies and trying out things we may not have time to use in everyday life.

Vagrant up and away

To make contributing easier we have provided a vagrant setup to allow people to run a machine that provides all the tools needed for our tech sandbox. To get all of this running follow these steps:

• Setup VirtualBox
• Setup Vagrant
• Setup Ansible (minium required version is 1.4)
• Execute vagrant up
• [optional] Add vagrant.amsterdamphp.nl to your hosts file pointing to 192.168.33.10

note: This box has a always running process that will constantly compile the less files into CSS while you work, you do not need to run it yourself.

How to contribute?

1. look at the issues, they are our guide, find something you are comfortable with and claim it
2. if details are lacking, start a discussion on the issue
3. run the behat tests for that feature (or write if needed)
4. write your code according to the guidelines below
5. run behat tests make sure everything is green
6. open a PR and wait for the review results by one of the project leads
7. ...
8. Profit!, no I'm kidding, but the learning process should indeed be a profit for you.

Booting up Vagrant Box

To make it easier for you to contribute and use all the new and shiny, we have setup a Vagrant box. It is provisioned with Ansible, so you need to have a few extra things, these are the steps

1. Install Ansible >=1.4 (See Docs or use HomeBrew on Mac OSX)
2. Install VirtualBox
3. Install Vagrant
4. Run vagrant up
5. Point vagrant.amsterdamphp.dev to 192.168.33.10
6. Code!

Grunt

To make building assets easy grunt is installed on the Vagrant box. If grunt is new for you be sure to read the getting started guide on their site. Using grunt is easy. Just running grunt will build all the assets. While grunt watch waits until you change something in the asset sources and rebuilds them when that occurs. When you like to know more about what happens when you run grunt run it with -v like this grunt -v to display verbose output.

Guidelines

• use PSR-2 guidelines to write code
• tests! Please add them along with your contributions
• practice writing good clean code, this is for learning.
• use the vagrant box included if you have trouble with dependencies

Technology sandbox

Like I said, learning experience, we want to pack some new stuff in here for us to experiment with, this may be familiar to some and new to others, that's where you come in to teach others.

• Symfony 2.3
• Behat and PHPSpec
• API's, lots of them.
• Vagrant + Ansible
• Redis
• Less
• Grunt

Any more suggestions?