How to work on the Accessibility site
The site is using the USWDS theme built with Jekyll.
How we work
We as a team have created a board where we can collaborate our work. Here we can track what work is in the backlog or in progress.
Email accessibility@civicactions.com or message in slack #accessibility for access to the GitHub repo Once added to the GitHub repo, if you find any issues, spelling mistake, or an idea you think should be added to the site, create an issue.
Create an issue
- Visit create an issue page
- Choose the type of issue
- Add new team member to repo
- Bug report
- Feature request
- General issue
- Retrospective
- Add a title and a description and click submit
The ticket will be added to the backlog column on the board
Working on an issue
All tickets should be kept in the backlog. Tickets in To-do column are added by a team member who is committing to working on this ticket in the current week. When working on a ticket, the ticket should be moved to the In-progress column on the board
How to add content
To create a page with content, can be done directly in GitHub. The repo has been set up for different sections
- About
- Calendar
- News
- Playbook (how tos)
- Guide (resources)
To add a page with no section click Add file
To add a page under a section when creating a new file in the main repo
- Click on the directory of the section your page will live.
- Click Add file.
Learn how to use markdown to create structured content.
How to set up a local environment
- git clone git@github.com:CivicActions/accessibility.git
- cd accessibility
- bundle install
- bundle exec jekyll serve -> this will continue to run while in development.
Creating a pull request
- git checkout -b your-name/issue-number
- git add files
- git push origin your-name/issue-number
A member with permissions to approve the merge of the pull request will review and merge your work.