18F / data-act-pilot

This small DATA Act pilot contains code that translates agency data to a uniform DATA act format.
Other
21 stars 14 forks source link

added web app copy #182

Closed elainekamlley closed 8 years ago

elainekamlley commented 8 years ago

@msecret -- this is ready for review. They are minor changes but maybe adds a little more clarity to the user. This will close #174

Also, this copy will likely change once the conversion feature is in place.

bsweger commented 8 years ago

Thanks @elainekamlley. Now that we have @emileighoutlaw's blessing on the documentation re-org, can we link to the how-to somewhere on the website (and maybe have it open in another tab?). Once merged, HOWTO.md will live in docs/HOWTO.md.

Also, what do you think about adding some text to the gray box on the left-hand side of the site to emphasize that this isn't fully featured, etc. Can probably crib some text from HOWTO, something like:

This prototype is a sandbox where you can test your agency's DATA Act files against the data standard as it evolves.

Find out more, including how to use the site and prepare your data in our how-to guide

elainekamlley commented 8 years ago

@bsweger I love it. I'll add it now.

elainekamlley commented 8 years ago

edited a little:

This prototype is a sandbox where you can test your agency's federal spending data against the DATA Act standard as it evolves. Find out more, including how to use the site and prepare your agency data in our how-to guide

emileighoutlaw commented 8 years ago

I like it!

On Tue, Sep 15, 2015 at 5:03 PM, Elaine Kamlley notifications@github.com wrote:

edited a little:

This prototype is a sandbox where you can test your agency's federal spending data against the DATA Act standard http://fedspendingtransparency.github.io/data-exchange-standard/ as it evolves. Find out more, including how to use the site and prepare your agency data in our how-to guide

— Reply to this email directly or view it on GitHub https://github.com/18F/data-act-pilot/pull/182#issuecomment-140539576.

bsweger commented 8 years ago

Yes, thanks @elainekamlley. Does the second sentence need a comma after agency data?

emileighoutlaw commented 8 years ago

Ah yes. I think it should probably be:

Find out more — including how to use the site and prepare your agency data — in our how to guide.

Also, strictly speaking, the hyphen is optional in this type of compound adjective. We try to avoid it, unless we think readers will be confused. In this case, I think everyone will understand what a "how to guide" is.

On Tue, Sep 15, 2015 at 5:16 PM, Becky Sweger notifications@github.com wrote:

Yes, thanks @elainekamlley https://github.com/elainekamlley. Does the second sentence need a comma after agency data?

— Reply to this email directly or view it on GitHub https://github.com/18F/data-act-pilot/pull/182#issuecomment-140546352.

elainekamlley commented 8 years ago

Made that edit @emileighoutlaw and @bsweger

bsweger commented 8 years ago

It would also be great if we could somehow incorporate artisanal mixologists into the website copy.

bsweger commented 8 years ago

Thanks, @elainekamlley! If @msecret is cool with this, then let us merge!

elainekamlley commented 8 years ago

@bsweger haha. I mean what are we doing if not artisanally mixing data?