You can see progress on tasks at http://waffle.io/devopsdays/devopsdays-web

devopsdays-web

This is the repo for managing devopsdays.org.

Contributing

The technical details and guidelines for contributing to this repository are outlined in CONTRIBUTING.md. If you intend to contribute (and we sure hope you do!), please take a moment to review that document.

Creating a new event

The easiest way to create a new event is with the make_new_event.sh script. Create a branch, run the script to make a skeleton site for your event, make any desired edits, and submit a PR as explained above.

1. If your city name has special characters or diacritics, the script will remove them when it creates the event stub.
2. Events need a data file in data/events, for example, data/events/2015-chicago.yml. It must be the same name as the directory you will create for your event. See the template data file for an example.
3. When the script copies the content directory from the sample site to content/events/YYYY-city, it removes draft = true from the frontmatter of the pages (so they will be built). Also, the welcome.md file needs to have a field added to its frontmatter for the alias, i.e., aliases = ["/events/2015-chicago"].

Once you have created a logo graphic, you will want to add it to the following directory (creating the directory if necessary) /static/events/yyyy-city/logo.png. The file MUST be called logo.png.

Special characters in city names

If your city has either spaces, or accented characters, you will want to add the optional parameter displayname to your yyyy-city.yml. The name and city parameters need to be named with "URL-friendly" (i.e., ASCII, no spaces), but displayname can have whatever you want in it.

For example, for Zürich, your event directory would be 2016-zurich, and the data file would have the following elements:

name: "2015-zurich"
year: 2015
city: "Zurich"
displayname: "Zürich"

Adding sponsors

Sponsors each need a file in the data directory, as such: data/sponsors/chef.yml. Please make sure to use the year for the sponsor (just so that the old events don't end up with newer sponsor logos, etc - but don't make one just for your city). If there is an existing sponsor and you can use it, you do not need to create the data file (or the image). If your information is different, please create a new file, such as data/sponsors/chefchicago.yml. (Note: there is an experimental feature for an "override" of the sponsor data; more on this feature as it is developed)

Put the images for your sponsors in the /static/img/sponsors directory. They need to be PNG files and named exactly after the name of the sponsor in your event file (and the corresponding sponsor data file), i.e., /static/img/sponsors/chef.png.

Sponsor logo guidelines

There are a few simple guidelines regarding sponsor logo files and formatting:

• The dimensions of the image file must be 200px square.
• The background must be either white or transparent.
• There must not be a border.

All logos will be constrained, via markup, to 100px square; combined with the image file dimensions, this allows for high-density display (ex. Retina) compatibility.

Note that a border will be drawn around the logo using CSS, so the logo shouldn't have one already.

Speakers & Program

The program is driven by the program.md file in your event (copied from the sample program.md. To generate a data-driven program, look at the Minneapolis 2016 speakers data files and program directory.

Speaker Images

The headshots for your speaker images should be exactly 500px wide (they display at 250px wide, but upload them at 500px wide in order to make them look good on retina displays). They must be in JPG format and named with the .jpg extension.

Binary files

Generally speaking, you should avoid storing any files other than logos or small images inside the repo itself (out of consideration for your fellow devopsdays organizers who have to pull down this repo). Please follow these guidelines:

• Do not upload presentations, artifacts from your event, etc. Either link to the preso on Speakerdeck/Slideshare from the presenter, or even better, create a Speakerdeck account for your event and put the presos there.
• Small, web images are fine (logos, etc). If you have high-resolution versions of your logo to share with others, please do not host them on the devopsdays-web repo.
• It is acceptable to add in a single PDF for your sponsor prospectus if you desire (in /static/events/YYYY-city), but please keep this file under 3 MB. It is better to host it on Google Drive or something similar, and then link to it from your site.