Giter Club home page Giter Club logo

opendatainitiative.github.io's Introduction

Project Overview

The Open Data Initiative website holds the published works of the Open Data Legislation project and Transparency project. We work on government financial transparency. Read the ODI about for more overview.

Submit issues and pull requests for updates, ideas, bug fixes, and new content.

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. Giving props where they are due, GitHub provides free web hosting for repositories, called GitHub Pages, and that's how this site is hosted.

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 issues.

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. This is the best way to test your changes before creating a pull request.

Requirements

  • Ruby v2.3.3 (installed default with macOS)
  • Bundler (binaries available with macOS)
  • Jekyll (binaries available with macOS)
  • Git (binaries available with macOS)

Installation

sudo gem install bundler
sudo gem install jekyll
git clone https://github.com/opendatainitiative/opendatainitiative.github.io.git
cd opendatainitiative.github.io
bundle install (do not bundle install as root)

Serving

bundle exec jekyll serve

Open http://localhost:4000 in your browser

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

License

The underlying Jekyll source code that used to format and display content is licensed under the MIT license, the non-code text content displayed by Jekyll is licensed under the Creative Commons Attribution 4.0 license, and code created by the project contributors is licensed under the Apache License 2.0.

opendatainitiative.github.io's People

Contributors

hansy avatar joffemd avatar sarob avatar soupytwist avatar

Stargazers

 avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar

opendatainitiative.github.io's Issues

Manipulate imported PDFs as data through policy

Project: Policy
Part 2 of 3 mass open data projects
Standard data import through API support of Storage project
Configurable policy rules using datalog
Policy results through standardized API
Existing projects: openstack Congress

publish daily workflow and release process

Manual process (this is easy while the number of contributors is low)

  1. There are three active projects. opendatalegislation and transparency project data is integrated in the opendatainitiative.github.io project that creates the https://opendatainitiative.github.io/ website.
  2. Each friday, each active project increments it's active branch revision number by 0.X.0 (tenth)
  3. If your changes are small and need to pushed before the end of the week, use branch revision number incremented by 0.0.Y (hundredth)
  4. Each contributor synchronizes their local repositories with the remote before starting work
  5. Review the issues. Bugs are highest priority and may be quick work. Enhancements may take days to weeks.
  6. Work the changes locally. Keep your work to a single problem or issue
  7. Verify the changes fixes problems and doesn't create new problems by running Jekyll locally. If you are working on the opendatalegislation or transparency project branch, you will need to copy your changes into the opendatainitiateve.github.io local repository to verify functionality. Make sure your changes are not in the master branch, rather in the next revision branch.
  8. When the branch changes are complete, push the branch to the repository. The commit message needs to include the issue (if any) that it closes or updates, e.g. "closes bug Correct CA legislation review first line to not public #35".
  9. If the contributor is a member of the Core Contributor team, the pushed changes can be merged with the current branch immediately.
  10. For everyone else, they need to create a Pull Request. One or more of the Core Contributor team member will review the change before the end of the week. Depending on the change, it may get merged with the master branch, request changes to the commit, request more explanation, delayed to a future revision, or declined.
  11. When a Core Contributor merges pushed changes to a branch, any referenced issues will be updated and closed if appropriate.
  12. When a branch is complete, a Core Contributor will take the branch and merge the revision branch with the master branch.
  13. During the week, a Core Contributor can decide a 0.0.Y hundredth branch revision needs to be published of in any of the opendatainitiative projects
  14. At the end of the business week (Friday), a Core Contributor will take the latest merged branch 0.X.Y, 0.J.K revisions of the opendatalegislation and transparency project data, copy the files into the branch 0.B.C revision of the opendatainitiative.github.io project. This consists of matching the changes in each project since the last merged branch to the current branch. Each of these files gets copied into the opendatainitiative.github.io project. The resulting local website will be double checked for errors. If the site fails to load or has other serious errors, the opendatainitiative.github.io project branch 0.B.C revision can be delayed until the end of the week (Sunday). If the end of the week opendatainitiative.github.io project branch 0.B.C revision is missed, then the revision is postponed until the following end of the business week.
  15. For the opendatainitiative.github.io project branch 0.B.C commit message, use each of the project branch URL
  16. After the all the project branches are updated, now the master branches need to be merged with the each of the latest branches. Once completed, each project latest branch and master must be pointing at the same, most recent change.
  17. Create the next revision branch in each project and change the focus to that branch, so your local changes always land in the correct place.

Future

  1. Code part or all of these steps to eliminate errors, speed development time, and allow more time to create unit and integration tests
  2. Continue to allow local CI toolchain while running the CI toolchain remotely. Each push would get some basic tests run, results logged, and published for core contributors to review.

Add release notes

  1. Github commits by repo
  2. Open linked issues
  3. Comment at top
  4. Drop notes into repo dir

future

  1. Create tarball.opendatainitiatve.io
  2. script the process

Work navbar section

  1. Work on navbar
  2. Discussion iframe plus pending long term issues
  3. Move project work from resources
  4. Most of page shows issues, projects
  5. Small upper right corner shows discussion with iframe of archive, how we work
  6. Each item points to issue
  7. Assign hours to issue
  8. All projects in one place
  9. Share this with ahmed and university

{{ name.2016-pirg-score }}" in transparency.md

Liquid Warning: Liquid syntax error (line 15): Expected id but found number in "{{name.2016-pirg-score | times: 0.80 | plus: name.accessibility | plus: name.downloadability | round: 1 }}" in transparency.md
Liquid Warning: Liquid syntax error (line 19): Expected id but found number in "{{ name.2016-pirg-score }}" in transparency.md

CA open data workshops

  1. PIRG and Sunlight Foundation have expressed interest in co-organizing
  2. Focus on Livermore, BART, and then Walnut Creek for three separate events
  3. I have reached out to CA Assembly Rep Baker to use these events as a springboard to get attention to open data legislation and the 'state' of government financial transparency in CA

Organize an Ohio Demo Data Day

Data Coalition generally runs these. They have a DC June 2018 date planned.
May 2018 is the ideal date for Ohio due to 2018 being an election season.
We need

  1. sponsors
  2. speakers
  3. session set aside for DataOhio meeting
  4. Organization to act as the bank and AR
  5. Schedule
  6. Site
  7. Lodging
  8. Registration

Import mass PDFs

Project: Storage
Part 1 of 3 mass open data projects
Import mass PDF as tokens stored in NoSQL
Import simple formats and XBRL
Other common RDBMS export formats or interfaces?
Create JSON, XBRL, and other formats from converted data sets for export
Provide standardized API access
Existing projects: pdftotext, pdfbox, pandoc

Add Edit Me to all pages

Bring up the contributor.md instructions page. Dynamic link to the editable page. Focus on simplest way to get first time contributors to push their edits to github for review.

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.