Giter VIP home page Giter VIP logo

codefordc-website's Introduction

Civic Tech DC Website

Welcome! This is the repository for the website for Civic Tech DC. It is a static site built with Jekyll. It is mostly HTML, Javascript, and CSS.

Getting Started

Quickstart with Codespaces

Github Codespaces is a free development environment based on VS Code that is run entirely in the browser. You can have your own copy of the Civic Tech DC Website up and running in a few clicks.

  1. Click "Fork" to make your own copy of the repository
    image
  2. Click "Create codespace on main"
    image
  3. Wait while your new Codespace starts, the dependencies will be installed and the web server will start automatically.
    image
  4. Click "Open in browser" to see your website running live! Click "Make public" if you would like to share with another user.
    image
  5. You can now modify the code and the website will automatically update.
  6. Commit your changes as usual, and open a pull request when ready to share back with the team.

Local Development

  1. First, make sure that you have git on your computer. Create your own fork of the repository, then clone it to your computer:

git clone [email protected]:[YOUR GITHUB NAME]/codefordc-website

  1. Now, install the correct version of Ruby.

We use asdf and its ruby plugin to configure Ruby for this project. You can see which version of Ruby we're using in the .tool-versions file.

First, if you're on Ubuntu, you may need to install some dependencies. If the install step doesn't work, try one or both of these commands:

sudo apt install libyaml-dev
sudo apt install libffi-dev

To install the Ruby plugin, run the following commands inside the project's directory:

asdf plugin add ruby https://github.com/asdf-vm/asdf-ruby.git
asdf install
  1. Install dependencies.

bundle install npm install

  1. Run a local version of the website.

This command will run gulp as a background process and then jekyll as a foreground process.

npm run serve

  1. Open a web browser page at localhost:4000

Issues

If you notice a problem or have an idea for an improvement you can submit an issue.

Contributing

Refer to the contribution instructions to contribute to this project. We have a project board where we track issues and ideas to be implemented.

Let us know if you get stuck in the Civic Tech DC Slack channel #civictechdc-website. Happy coding!

codefordc-website's People

Contributors

danbjoseph avatar gamedevdebbie avatar gregjd avatar jschnapper avatar kasigi avatar marievh avatar mchelen avatar mikewolfd avatar mkalish avatar nicksto avatar pekingpow avatar sheldon-b avatar stvnrlly avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

codefordc-website's Issues

Update donations to go to OpenCollective

Code for DC has changed fiscal sponsors and our donation page no longer works for the new fiscal sponsor. We should update it so that people can donate money to us.

Our previous fiscal sponsor was Code for America. Our new fiscal sponsor is OpenCollective.

OpenCollective has some documentation on how people can donate. It's not clear at a glance if we'll need to link to our OpenCollective org, or if we can embed a donation form into codefordc.org

This ticket includes:

  1. Research OpenCollective's process for collecting contributions. What are our options, technically, for collecting donations?
  2. Proposing a technical solution (which could be linking to our OpenCollective profile, or integrating some sort of donation form into codefordc.org
  3. Implementing the new donation mechanism

We're serving the minified css but it's not in the build

Currently (as of 075ba86), the CSS referenced by the html is css_new/uswds.min.css. Normally, that would be built from the source file css_new/uswds.css. But it's not actually being minified in the build process. The minified file we're actually serving is committed to the repo, so it's static unless anyone manually updates it.

Heads up: this bug was very hard to find because the mapping between the source file and minified file (css_new/uswds.min.css.map) is also a static file committed to the repo. So looking in the browser's dev tools shows unminified css that won't match the actual unminified css you're editing.

"As a new person, here's what I want to know"

People's comments:

Matt Gordon

The 2 things I wanted to know about Code for DC:

Dates/Times/Locations for Meetings

List of Current ongoing Projects and their Startuses (where they are at and what needs to be completed)

Maria Skibniewska

Links to social media so I can follow Code for DC, in big, colorful, obvious icons at the bottom (edited)

Resources for first-time coders

side note: make a facebook and instagram

a "media" section of news articles about projects

friendly-looking color scheme

not too much burgundy and black

Melissa M

Upcoming events/project nights (calendar)
Active projects
Past projects
How to submit a proposal
Background (how it works, who runs it)
Join the slack channel
Announcements and job listings
Donate
Resources (learning materials, free online courses, etc.)

Sol Vitkin

I think the main thing for me would be information on all the projects:

  • link to GitHub
  • short blurb on project description
  • all the tech currently being used on project
  • status of project
  • contact information for someone to talk to about the project

Also a part of the website that lists some of the stuff (like Docker) that are used on most/all of projects and links to tutorials

Create an about page and FAQ

Answering questions like:

  • What kind of experience do I need?
  • Is there a regular schedule to the project nights?
  • What types of projects get worked on?
  • What skills are you looking for?
  • What would I be working on?
  • What if I have an idea for a project?
  • Will I get paid or is this a volunteer thing?
  • Are you part of any network of organizations?

hero-p on mobile bug

the hero-p paragraph on mobile overlaps with the logo. Changing the margin-left to 70%/80% resolved it and also looks better IMO on the desktop version too. I don't want to do a pull request just to change one number so I'm adding this comment

Thanks!

Fix location links for upcoming meetups

In the "Join us at one of our upcoming project nights!" section, each upcoming meetup's address is a hyperlink that's supposed to take you to a Google Map of the meetup location.

On the old website, it does the expected behavior correctly: https://codefordc.github.io/

On the new site, it does not. Instead, it takes you to a super-zoomed-out map.

For the new site, here's the script that's adding meetup info to the home page: https://github.com/codefordc/codefordc-website/blob/master/index.html#L170

On the old site, here's the script that did that: https://github.com/codefordc/codefordc.github.com/blob/master/assets/js/meetup.js

"Join Slack" 404 error

The link we put on hackpads for people to join our slack channel doesn’t work. The link on our homepage does work so maybe we should just update what we put on hackpads? Either way, maybe the page that doesn't work needs to be deleted?

This is the url that doesn't work: codefordc.org/joinslack
The one that does work is: https://codefordc.org/resources/slack.html

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.