18f / ads-bpa

A guide for the Agile Delivery Services BPA

Agile BPA micro-site

This is a skeleton repo containing the CFPB/DOCter-based Jekyll template for 18F Guides.

Getting started

Installing Ruby

You will need Ruby ( > version 2.2.4 ). To check whether it's already installed on a UNIX-like system, open up a terminal window (e.g. Terminal on OS X) and type ruby -v at the command prompt. For example, you should see something similar to the following:

$ ruby -v
ruby 2.2.4p230 (2015-12-16 revision 53155) [x86_64-darwin15]

If the version number is less than 2.2.4, or instead you see something like:

$ ruby -v
-bash: ruby: command not found

Then Ruby is not installed, and you should choose one of the installation methods below. The "Installing Ruby" page of the official Ruby language web site explains how to do this in a number of ways across many different systems.

Quickest Ruby install/upgrade for OS X

On OS X, you can use Homebrew to install Ruby in /usr/local/bin, which may require you to update your $PATH environment variable:

$ brew update
$ brew install ruby

Optional: using a version manager

Whether or not Ruby is already installed, we strongly recommend using a Ruby version manager such as rbenv or rvm to help ensure that Ruby version upgrades don't mean all your gems will need to be rebuilt.

Cloning and serving the Guides Template locally

To create a new guide and serve it locally, where MY-NEW-GUIDE is the name of your new repository:

$ git clone https://github.com/18F/guides-template.git MY-NEW-GUIDE
$ cd MY-NEW-GUIDE
$ ./go serve

The ./go script will check that your Ruby version is supported, install the Bundler gem if it is not yet installed, install all the gems needed by the template, and launch a running instance on http://localhost:4000/.

Follow the template instructions

The Guides Template (either running locally or the published version) will walk you through the rest of the steps to edit and publish your guide.

Public domain

This project is in the worldwide public domain. As stated in CONTRIBUTING:

This project is in the public domain within the United States, and copyright and related rights in the work worldwide are waived through the CC0 1.0 Universal public domain dedication.

All contributions to this project will be released under the CC0 dedication. By submitting a pull request, you are agreeing to comply with this waiver of copyright interest.

ads-bpa's Issues

Bug: small typo

The last sentence on .../.../2018-revamp/working-with-us/our-project-team/ has "hte" instead of "the."

Open Source Tech for FedRamp Dashboard?

Congrats to TrueTandem on winning the first task order, to build a FEDRAMP dashboard. We've recently released a react.js based set of open source data dashboard building tools, and we'd love to have them leveraged (and contributed to!) for this project, if useful:

https://github.com/NuCivic/react-dashboard

And regardless, we'd love to learn what tools TrueTandem does use for this dashboard, and see what new FOSS capabilities result! :)

Convert prices in data/orders.yml to floats

right now all the price data is in strings but we should convert to floats and do front end processing to a $"xxx,xxx" format so that the data can be more readily processed by other machines.

Move link to RFQ to the front page

The pdf of the RFQ needs to be clear on the front page of the Intro page.

Refactor the dashboard to pull data programmatically

Right now the dashboard is hardcoded. But it would be great if we used liquid and jekyll and data_source to pull the data automatically.

When none in category, say so!

Right now, when there's no solicitation on the street, it looks silly. We should add some text to signal there are no active solicitations, but watch this page for more information!

Move link to Labor Categories to the front page

Took me googling to find them: https://pages.18f.gov/agile-labor-categories/

(I'm open to other Nav options, of course)

Award data updates to .yml orders page

@oghaffari and @rrefoy , when you have a minute, can you populate HUD and FS#2 Mean, Median, and std-deviation under /data/orders.yml? Please take a minute to commit to the branch wong-20170414_dataupdate.

• (Also, take a beat and look at the award date, I'm pretty sure I'm wrong on both fronts.)

Place awarded orders on a different page

As a user, I would like to be able to tell which orders have been awarded and which are forecasted. The current layout requires scrolling and reaching every entry on the page to determine its stage in the procurement process.

Move to a new CI/CD system

This repository has been using Travis CI, however access to Travis CI is now turning off. When you need to use this repository again, convert it to a CI/CD system which is in the ITSP such as Circle CI.

Change "anticipated soliciation date"

Maybe this is a bigger layout issue, but "anticipated soliciation date" is the wrong field name for task orders that have been awarded. Maybe two tabs? One for awarded task orders and one for open task orders?

Brainstorming in here for now, we should discuss.