Closed elainekamlley closed 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
@bsweger I love it. I'll add it now.
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
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.
Yes, thanks @elainekamlley. Does the second sentence need a comma after agency data?
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.
Made that edit @emileighoutlaw and @bsweger
It would also be great if we could somehow incorporate artisanal mixologists into the website copy.
Thanks, @elainekamlley! If @msecret is cool with this, then let us merge!
@bsweger haha. I mean what are we doing if not artisanally mixing data?
@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.