Git Product home page Git Product logo

government.github.com's Introduction

GitHub and Government Test site build

screenshot

Gather, curate, and feature stories of people using GitHub as part of their open government innovations.

The site is open source (here's all the code!) and is a tool for and by the community.

Submit issues and pull requests for stories, site ideas or copy edits.

Goals

  • Share stories of real world experiences using GitHub in open Government
  • Demystify open source terminology
  • Showcase the community using GitHub to promote connections and sharing between individuals and organizations.
  • Make getting started with GitHub easier

Under the Hood

This site is made with Jekyll, an open source static site generator. This means the Jekyll program takes the content we want to be on the site and turns them into HTML files ready to be hosted somewhere. Awesomely, GitHub provides free web hosting for repositories, called GitHub Pages, and that's how this site is hosted. The content for the site is on a branch named gh-pages.

Contributing

Fix/Edit Content

If you see an error or a place where content should be updated or improved, just fork this repository to your account, make the change you'd like and then submit a pull request. If you're not able to make the change, file an issue.

Add Organization

If you know of an GitHub organization that should be added to the organization list that generates the matrix of avatars on the Community page: fork this repository, open the _data/civic_hackers.yml, _data/governments.yml, or_data/research.yml file and add it to the appropriate section of the list in the format being used. Commit your change and submit a pull request to us!


To Set up Locally

You can take all the files of this site and run them just on your computer as if it were live online, only it's just on your machine.

Requirements

If you have installed GitHub Desktop, Git was also installed automatically.

To copy the repository's files from here onto your computer and to view and serve those files locally, at your computer's command line type:

git clone https://github.com/github/government.github.com.git
cd government.github.com
script/bootstrap
script/server

Open http://localhost:4000 in your browser

Deploying

government.github.com now utilizes a two-repo approach to managing staging and production deployments:

For small changes, you can deploy right to production by merging a pull request. For larger changes, push your branch to the staging repo from Terminal. Here's how to setup staging and deploy to it:

$ script/stage staging

This script will generate the government site (without starting the local server) and prep it for staging. It does this by creating a temporary Git repo within the compiled _site directory and force pushing that to a separate remote repo (in this case, https://ghe.io/government/staging).

Pushing to the staging repo requires authenticating with GitHub via Terminal. You'll be asked for a username and password when running script/stage. Use your GHE.io username and, since we enforce 2FA, use a personal access token as your password.

Having trouble deploying to a staging server? Delete the entire _site directory and try again. Sometimes the temporary Git repository we make in the script can go awry.

When you're done with staging and your pull request has been approved, you can merge your branch. Your changes will be automatically deployed to the production site in a few minutes.


Triage Issues Open Source Helpers

In addition to contributing changes, you can help to triage issues. This can include asking for vital information or requesting formatting changes. If you would like to start triaging issues, one easy way to get started is to subscribe to government.github.com on CodeTriage.


Don't see what you're looking for? Create an issue, we'll do our best to help you out.

License

The data in _data is free to use without restriction. For clarity these files, and contributions to these files, are released under CC0-1.0.

When using the GitHub logos, be sure to follow the GitHub logo guidelines.

government.github.com's People

Contributors

aepstein avatar afeld avatar benbalter avatar bruceravel avatar claudiuceia avatar codedust avatar cwtaylor avatar dr0i avatar elstudio avatar emilyselwood avatar ivbeg avatar jbjonesjr avatar josepjaume avatar jystewart avatar leahbannon avatar leereilly avatar mattisg avatar maxious avatar mlinksva avatar nschonni avatar parkr avatar petess avatar phil-blain avatar pierremesure avatar randomecho avatar sonalkr132 avatar suriyaakudoisc avatar websnke avatar xhmikosr avatar yasarshaikh avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

government.github.com's Issues

Slick 404 page

Perhaps with an automatic search based on the url.

Should just live at /404.html.

Zen the zen, pls

Hi! In zen mode, even in fullscreen, there's still a sad scrollbar an no way (I can find) to reduce font. Very hard to visually ID linebreaks.

I can haz expanding margins?

image

Run scripts not working

Hello everybody, 😄

I need your help!

I tried today to *run over Git Shell* script/bootstrap and script/server on my Laptop but it doesn't work. 😒

So it looks when script/bootstrap is finished:
screenshot 2014-09-22 16 34 27

So it looks when script/server is finished:
screenshot 2014-09-22 16 35 06

Thanks for your help.

Yours,
Suriyaa Kudo :octocat:

(PS: I install "nokogiri" and "bundle" and it's still not work.)

Negative margin on featured-orgs class and static image

Why is .featured-orgs has negative margin of 55px? Images are overflowing the screen because of it:
screenshot from 2015-09-23 09 54 17


Also why are these featured org avatars are stored in repo? Why isn't it using something like (check src property):

<img class="animate-in" src="https://github.com/{{ org }}.png" width="80" alt="View {{ org }}'s profile on GitHub">

Can I make above two changes?

Work around symlink issue

C:\Users\xmr\Desktop\government.github.com>ruby -v && gem -v
ruby 2.2.4p230 (2015-12-16 revision 53155) [x64-mingw32]
2.5.2

C:\Users\xmr\Desktop\government.github.com>bundle exec jekyll s
Configuration file: C:/Users/xmr/Desktop/government.github.com/_config.yml
            Source: C:/Users/xmr/Desktop/government.github.com
       Destination: C:/Users/xmr/Desktop/government.github.com/_site
 Incremental build: disabled. Enable with --incremental
      Generating...
  Conversion error: Jekyll::Converters::Scss encountered an error while converting 'assets/css/style.scss':
                    File to import not found or unreadable: bootstrap/stylesheet
s/bootstrap. Load path: C:/Users/xmr/Desktop/government.github.com/_sass on line 2
jekyll 3.0.3 | Error:  File to import not found or unreadable: bootstrap/stylesheets/bootstrap.
Load path: C:/Users/xmr/Desktop/government.github.com/_sass on line 2

Or if anyone has any other solution, please let me know.

/CC @benbalter

How should the levels of government be laid out

Not to promote silos :trollface: but ...
There is currently a slight disconnect with US splitting between Federal, State, county, and City vs. the rest of the world.

  1. Each country splitting between levels (with separate h2's and grids?)
    • Country/Federal
      • Country A
    • State/Province
      • Washington
      • Ontario
    • City/County
      • ...
  2. Country as the high level
    • US
      • Federal
        • ...
      • State

Community grid not displaying correctly

I'm guessing during one of the merges of the updates to the css/bootstrap/whatnots that something got changed that created this bug in the display of orgs on /community:

screen shot 2013-11-04 at 11 52 18 pm

There shouldn't be almost blank rows. It's happening if a type-block ends up in the last position of a row.

Will try and fix it in the morning (it's late here!).

Translations of site

Since this is highlighting international work, it may be a good idea to look into crowdsourcing some translations

How to add a story?

In the README, there is a section for Add a Story that references instructions in docs/submit.md that doesn't seem to exist.

Are the instructions just hosted someplace else now? Is adding a story still an option?

Thanks!

Optimize /community page load

As the number of government organizations on GitHub has grown, so too has the load time of the /community page.

I'm less concerned about the load time as I am about the experience of actually using it. For example, even if you know what you're looking for, it's hard to read, as your scroll, as the images load and the dom reflows. This is especially true if you enter via an anchor link (which then isn't where you want it).

I tried setting the height explicitly on images, but it didn't seem to help. Perhaps we could do one of those fancy javascript fade in loads? @jlord know this was your 👶 originally, any thoughts / strong opinions?

See also #304

Avatar downloads on the Community page

Adding the s= query parameter would shrink down the size of the images downloaded, but that doesn't work unless you resolve the github user content url first. Ex: https://avatars3.githubusercontent.com/u/1297909
30px Avatar ?v=2&amp;s=30
100px Avatar ?v=2&amp;s=100

Since passing the format https://github.com/nschonni.png?s=30 doesn't pass through the query params, maybe you can look up on your side to see if there is a trick to get it to request the right size.

2 small errors

  1. the /about page talks about "export restorations";
  2. the link to github.com at the bottom of the pages links to status.github.com instead.

- Felix

Consolidate U.S. Federal & U.S. Military and Intelligence in governments.yml

No other country breaks their list of "Federal" accounts this way and don't see what added value there is as source code and projects can find re-use across military and civilian sectors. This only adds un-needed complexity to keep the list up to date for the US having to compare three lists in what should be two list within two files:

Related:
#461

Reduce http requests and redirects

Initially mentioned here #127 (comment).

There are so many http requests ~320. And most of them are because of redirects from github to gravatar.

Now since most organizations in #orgs are hidden with overflow: hidden;, they shouldn't be in index.html in the first place IMHO.

Another approach would be to use a css sprite but that won't be so flexible.

Use CDN for third party libraries

Rather than bumping a few of the recent threads, I wanted to float using CDN copies directly in the templates rather than including the libraries through Bower. I love Bower, but most of these libraries have CDN equivalents that are excellent when no customization are needed (and have a better change of hitting users browser cache).

/cc the awesome work by @benbalter and @XhmikosR

Add section on Open Data Websites

Add section on Open Data Websites and related repos.

Subsection/Partner section would contain list of repos on GitHub that leverage the specific Open data sources.

Potential stories would include apps, mobile apps, data scrapers, open data platforms like CKAN (http://ckan.org) and DKAN (https://drupal.org/project/dkan), visualization tools, news stories that occurred about the work being done, etc.

Any interest in a shoutout for GitHub Training?

Just curious on the team as well as communities feelings about a mention of GitHub Training being available for government bodies if they're interested.

Some text and message similar to:

Interested in Training? We have a team at GitHub specifically for that. Contact [email protected] to start the discussion today!

Full with professor_octocat_v2 or something.

Thoughts?

no access permission to '/'

Hi I followed the instruction in READMD.md and finished running ./server. It instructed me to open localhost:4000/ but when I did that, it just gave me error that no access permission to '/'. Could you please explain this is happening? Thank you.

Convert user account to organization account

Doing a little clean up of the government organizations list at government.github.com/community and I noticed the follow government "organizations" are really GitHub users.

Being a GitHub organization (rather than a user) provides government organizations with lots of advantages like team-based access permissions, unlimited owners, admins, and collaborators, the ability to audit 2FA status, and access to business-oriented plans.

Think about it like the difference between your personal account on Facebook, and having a Facebook page. For more information see What's the difference between user and organization accounts?.

If your name is listed below, and you're a government organization, I'd strongly encourage you to Converting your user into an organization. It takes seconds, and won't break existing URLs or disrupt developers' workflows.

Ideally, we'd only like government organizations to be listed on government.github.com/community. If you have any questions, or don't want your name listed for some reason, please feel free to reply here, or contact me directly at [email protected]. 😄


@2EK
@CarersBeta
@edelegationen
@EducationDataInitiative
@foreignassistance
@GemeenteBoekel
@GemeenteDeWoldenHoogeveen
@GemeenteEdamVolendam
@gemeentehoogezandsappemeer
@GemeenteKoggenland
@GemeenteLingewaard
@GemeenteLochem
@GemeenteMontferland
@GemeenteNunspeet
@GemeenteRheden
@GemeenteTynaarlo
@GemeenteUrk
@GemeenteUtrecht
@GemeenteVeere
@GemeenteWaalwijk
@GemeenteWeststellingwerf
@IenS-Velsen
@MinIenM
@NCBITools
@ouropendata
@sfgov
@state-hiu

Link out to government showcase

Via @adamjacobbecker, we should link out to the government app showcase from government.github.com in a big way.

Mirroring the features "learn more" link, thinking it'd make the most sense to add it below the "how to use GitHub" section. Don't ❤️ the copy, but something like:

screen shot 2014-07-29 at 9 50 31 am

@jlord, any suggestions?

License

Sorry, but where can I find a license for scripts and fonts? :)

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.