dfischer / betterfrontend

A community recommendation on how to make front-end development better. How-to, best-practices, and more.

Home Page:http://www.betterfrontend.com

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

CURRENTLY BEING REWORKED - repo is mostly deprecated/old. DONOTUSE.

Betterfrontend

Front-End Development lacks consistency. Betterfrontend is a community-driven project to bring best-practices and consistency to Front-End Development.

Secondarily, Betterfrontend will be a repository of tutorials to reduce the learning curve of becoming a front-end developer.

The guides are viewable at www.betterfrontend.com.

You can also follow @betterfrontend on Twitter.

The entire web-development community is encouraged to contribute to these guides. It's easy to contribute.

Contributing

You can contribute in many ways. Just having a voice is a contribution so shout about betterfrontend on Twitter, or create an issue about things that annoy you with front-end-development.

If you're feeling particularly involved, you can fork the project.

The site and docs are built using middleman to make developing a static site easy.

Simply check out your forked repository and then run bundle install and you can run the site locally by typing middleman in the root directory.

Now you can edit the site & docs!

When you're ready to contribute back, simply create a pull-request back to the main repository and we'll review it.

How It's Deployed

The @betterfrontend site is deployed on GitHub pages.

The recommended folder structure is as follows:

betterfrontend/
  main-repo/
  betterfrontend-pages/

The main-repo/ folder is where you're currently reading this and has all the source/doc files for the site. When the site is ready to be built we middleman build which outputs to betterfrontend-pages/ which is an orphaned branch that is deployed to GitHub.

You probably don't need to know this as a contributor but knowledge is power!

About

A community recommendation on how to make front-end development better. How-to, best-practices, and more.

http://www.betterfrontend.com


Languages

Language:JavaScript 76.5%Language:CSS 13.1%Language:Ruby 10.4%