UBC Envision - The AIChE Student Chapter of the University of British Columbia (UBC).
This website is hosted for free on GitHub Pages. We write our content in Markdown and use Jekyll to generate a fast, static and low-maintenance website available at www.ubcenvision.com. Our website design is based on a heavily-modified theme called Story by HTML5Up. Our blog and news articles support MathJax.
Our website data is organized into several folders:
- Members: information about our team members and alumni members
- Blog: blog articles
- News: news articles
- Pages: all website pages and layout information
- Projects: project information
master branch is protected and commits cannot be made to this branch directly. We use Travis CI to run RSpec tests to ensure all contributions meet our code quality requirements and website standards.
🐳 We now support docker! 🐳
It is now SUPER EASY to contribute to the UBC Envision site with Docker support thanks to @bretfisher!
Step 1: Install Docker
- Go to the Docker website
- Download for your operating system (Windows, Mac, etc...)
Step 2: Start Docker
- Click on the Docker icon
🐳! For Mac it should be in the top menu bar
- Select start docker
Step 3: Run a Local Website
- Go to your terminal
- Navigate to the repository
- Run the following command:
- Open a brower and navigate to http://localhost:4000/
Please take the time to read the contribution guide before you contribute! These are guidelines, not rules. For those with limited coding experience and those who want to learn these will outline some of the best practices to contributing to open source projects. We are aiming to teach best-practices to junior developers so that they are more familiar with work-flow when they reach industry. Members, if you have any questions feel free to message
website channel in Slack for a quick response.
Check out Github's Open Source Guide here for more details.
The FIRST thing you should do when you find something wrong with the website or want to change something is create an issue.
It is best practice to tag your issues! Types of issues include:
If you find a bug, report it! Submit an issue on Github here and it will be addressed. Ensure to tag it as a bug so that we know to fix it as soon as possible.
Old info can mislead people. It is best to address this ASAP! If you find out-of-date info submit an issue and tag it as update-info.
Have an idea for a cool new software project? Want to make this the best website ever? Submit an issue and tag it as an enhancement. Give us an idea of what you would like to see as a part of this enhancement and see if you can get some help working on it!
The 7 Rules to a Great Commit Message
- Separate subject from body with a blank line
- Limit the subject line to 50 characters
- Capitalize the subject line
- Do not end the subject line with a period
- Use the imperative mood in the subject line
- Wrap the body at 72 characters
- Use the body to explain what and why vs. how
Check out more details here. Thanks to Chris Beams for an awesome how-to article on commit messages.
Fill out the pull request template and let us know what changes you made! Ensure that the changes are reviewed by another set of eyes before you submit them. For structual changes to the website, make sure that the code is reviewed before it is merged to the master branch.
Check Us Out!
Based on Story by HTML5 UP - html5up.net | @ajlkn