A community–driven effort to make web accessibility easier.
Switch branches/tags
Nothing to show
Clone or download
ericwbailey Documentation updates (#640)
* Documentation overhaul

* Fixed nested lists

* Update list types

* Copy tweaks

* Add attribution step for a new author

* Added note about blog post headings

* Updates based on Scott’s review feedback

* Add links to terms
Latest commit c606762 Sep 21, 2018
Permalink
Failed to load latest commit information.
_data Update events.yml Sep 19, 2018
_layouts Add more post attribution (#638) Aug 26, 2018
_posts Recategorize as background Sep 12, 2018
_sass cleanup Jul 22, 2018
css add syntax highlighting styles Feb 7, 2017
fonts Logo Icon and Fallback. Tested for Android 2.2 & 2.3, IE7 & IE8 Jan 18, 2013
img Updated social share code (#604) Jun 14, 2018
js Add a 24 hour buffer before an event is moved Dec 21, 2017
script chore: re-sync bootstrap script from GH Aug 18, 2017
.editorconfig bare bones skeleton Feb 24, 2015
.gitignore chore: bump Ruby to 2.4.0 Aug 18, 2017
.ruby-version chore: bump Ruby to 2.4.0 Aug 18, 2017
.travis.yml Add scripts and instructions Mar 16, 2017
CNAME Updating CNAME Jan 14, 2013
CONTENT_STYLE_GUIDE.md Documentation updates (#640) Sep 21, 2018
CONTRIBUTING.md Documentation updates (#640) Sep 21, 2018
Gemfile chore: update Gemfile for GH recommendations Aug 18, 2017
README.md Documentation updates (#640) Sep 21, 2018
Rakefile Add scripts and instructions Mar 16, 2017
_config.yml Updated social share code (#604) Jun 14, 2018
about.md Updated About page language (#586) Feb 27, 2018
archives.html re-add ‘media-heading’ class Aug 28, 2017
checklist.html updated per review Jan 15, 2018
events.html Added event submission expectations Jan 18, 2018
favicon.ico Updated social share code (#604) Jun 14, 2018
follow.html Added Who to Follow page and data. Oct 17, 2017
index.html 455 - Add right column to checklist - normalize all columns - remove … Sep 3, 2017
patterns.html Merge pull request #510 from nschonni/setup-script Aug 28, 2017
resources.html Merge pull request #510 from nschonni/setup-script Aug 28, 2017
robots.txt Initial commit Jan 11, 2013

README.md

The A11Y Project logo. An abstract human silhouette with outstretched arms centered in a dark blue circle.

The A11Y Project

The Accessibility (A11Y) Project is a community-driven effort to make web accessibility easier. We do this by leveraging a worldwide community of developer knowledge.

The A11Y Project is guided by three principles:

  1. Digestible. Articles on accessibility tend to be in-depth, sometimes to their detriment. We prefer to feature short, digestible pieces of content.
  2. Up-to-date. We strive to keep information current with the latest standards and the realities of real-world technology support.
  3. Forgiving. People make mistakes and web accessibility can be difficult, so we seek to be encouraging.

Contributing

You can learn about helping this project by reading our Contributor documentation and Content Style Guide. Please familiarize yourself with them before submitting content.

Local Development

Requirements

In order to get the website running locally on your computer, you'll need access to the following programs and technology:

  1. A command line application such as Terminal.
  2. Git version control and a GitHub account.
    • You can check to see if Git is already installed on your computer by typing git --version into your command line application. If it is installed it will list the currently installed version (e.g. git version 2.18.0).
    • If you prefer to use a GUI to work with version control, GitHub offers a free desktop app.
  3. The Ruby programming language.
    • You can check to see if Ruby is already installed on your computer by typing ruby -v into your command line application. If it is installed it will list the currently installed version (e.g. ruby 2.4.0p0 (2016-12-24 revision 57164) [x86_64-darwin17]).
    • It may also be helpful to use rbenv, a command line program that helps manage your Ruby versions.
  4. bundler, a command line application that helps manage Ruby Gems.

Technology

The A11Y Project uses Jekyll to manage its content. Jekyll relies on Markdown, Sass, and YAML to function. It may be helpful to familiarize yourself with these technologies, depending on what you want to do. For more information, check our our Contributor documentation.

Installation

Once you have met the prerequisites, follow these steps to install the website on your computer:

  1. Clone this repository by entering this command into your command line application: git@github.com:a11yproject/a11yproject.com.git. It will create a version controlled copy of the website in the directory you entered the command in.
  2. Navigate into the project's root directory by typing cd a11yproject.com in your command line application.
  3. Install the project's Ruby Gems by typing bundle install into your command line application. A list of Ruby Gems will be displayed after they are downloaded and installed.

Running the website

After cloning and installing project Ruby Gems, type jekyll serve into your command line application. This will tell Jekyll to compile the project and turn it into a website.

Your command line application will then display some information about Jekyll, including a line about Server address:. You can copy the URL it points (it should read something like http://127.0.0.1:4000) to and paste it into a browser tab. This will load a local copy of the website that you can interact with to preview your changes.

Saving project files will make Jekyll regenerate the website to reflect the changes you made. Your command line application will display some new messaging to reflect this, including any errors you might accidentally make. Don't worry! Since the site uses version control, you're not in danger of seriously breaking anything. If you fix the error, Jekyll should continue to run.

You can tell Jekyll to stop running by pressing the Control and C keys at the same time in your command line application.

Troubleshooting

If you are experiencing Ruby issues that prevent you from compiling the website, try this command instead: bundle exec jekyll serve. This will tell bundler to execute the command instead of Ruby.

If jekyll serve was the last command you typed into your command line application, you can press the up arrow on your keyboard to bring it back, then hit Enter to run it again. This can sometimes be helpful when you want to force the entire site to be regenerated from a "cold start".

Other issues about installing and running the website can be addressed in the site's Issue Tracker.