adelevie
In the shorter term, do check out https://micropurchase.18f.gov. It's where we post very short term contract opportunities ($3,500 or less, and tasks typically take up to a week). I also happen to be a dev on this project, so feel free to reach out here or at [email protected] if you have any questions.
According to https://www.govcode.org/repos, there are about 1,300 U.S. government repos on GitHub that do not belong to 18F.
If you're generally interested in how we do ATOs, https://pages.18f.gov/before-you-ship/ato/ is a nice internal guide for our devs.
(I work at 18F)
This is where these kinds of issues typically go off the rails. With male-gendered language as the default, I doubt very many people intend to do anything wrong. It's how I learned to speak and I'm sure it's how many others did, too.
A silly nudge from a Slack bot, is just that--not an accusation or a judgment of character.
I was thinking about this a bit more last night, and I thought of another reason why the bot is great: it doesn't discriminate. It doesn't matter if you are in leadership at 18F, a guest user in our Slack, an employee who started two weeks ago, male, female, or something else. The bot doesn't care.
There's a bit of politics to how people get "called out"--e.g. who wants to pull the boss aside and correct their behavior? The end result is likely to be that certain employees get corrected and other employees don't. A bot avoids all of this.
Of course there are boundaries to the happiness-increases-productivity dynamic, but quickly coding up a Slack bot seems well within the safe range.
It's been pretty well established that needlessly (male) gendered language makes people feel excluded. Actually, that's too nice. That kind of language excludes people. Period.
It communicates that the speaker does not contemplate a non-male audience. I do not know about the communities that you moderate, but constantly assuming a male audience at a place like 18F is wrong factually and is disrespectful.
I've triggered the slackbot by using "guys" many times and I've never felt that this was aggressive in any way. It's usually a chuckle-worthy experience for all involved. And that's why I love the bot. I do understand concerns over "policing" language. No one wants to feel pestered into writing/talking in a way that feels unnatural to them. However, instincts should not be above criticism. And a silly bot[0] is a great way to gently, politely, and humorously help people unlearn behavior that excludes.
[0] We have other silly bots, too. The one we probably love to hate the most is angrytock (https://github.com/18f/angrytock), which will remind us to submit our time cards (using our open source time tracker, Tock. https://github.com/18f/tock).
Some quick feedback (and a shameless plug):
The CLI interface should output JSON. It would be nice to combin with a CLI JSON parser such as jq[0].
Shameless plug: I've been working on a PDF CLI aimed at making it easier to programmatically fill out PDF forms: https://github.com/adelevie/pdfq. It provides an interface and some wrappers on top of the main pdf form-filling tool, pdftk. For example, you can get json out of a pdf form like this:
pdftk hello.pdf dump_data_fields | pdfq
Or you can generate FDF from a json file: cat hello.json | pdfq json_to_fdf
You can also fill a pdf without touching an fdf code: pdfq set foo bar input.pdf output.pdf
[0] https://stedolan.github.io/jq/Yes. Keep scrolling :)
> 18F is working with a number of different federal departments. One of the biggest projects it has taken on is designing the website for U.S. Citizenship and Immigration Services. That's the agency that processes applications from people hoping to become citizens and those covered under the president's executive actions who hope to obtain work permits. Godbout says the concept for the USCIS website is to make a virtual welcoming statement.
> He thinks of it as an "online Statue of Liberty. This idea of how do we present ourselves to people coming to America. Our digital process should be that beautiful, too."
source: http://www.npr.org/blogs/alltechconsidered/2015/01/28/382178...
[0] https://github.com/18F/api-standards
[1] https://github.com/18F/jekyll_pages_api
[2] https://github.com/18F/API-All-the-X and http://18f.github.io/API-All-the-X/
[3] https://github.com/18F/api.data.gov
[4] https://github.com/18F/fbopen
[5] https://github.com/18f/?query=api etc, etc
Merely choosing to withhold information about yourself does not insulate you from a breach of privacy. That others do disclose such information allows 3rd parties to make really good guesses and inferences about you.
There's a strange morality here: at what point is it unethical to voluntarily disclose data about oneself, if it could be used in a way to harm someone else's privacy? Short of drawing a moral boundary (it could very well be impossible), we might do well to at least acknowledge the cost to these methods, alongside their benefits.
[1] (https://github.com/vzvenyach/codingforlawyers/pull/10) [2] https://github.com/vzvenyach/codingforlawyers/issues/5
Just one of many examples of how lawyers can use tech to make their day jobs easier.
I will point out that JSON is recommended as a default, and if there is a compelling reason not to use it in a specific case, that should be fine[2].
[1] https://github.com/18f/api-standards/issues or https://github.com/18F/api-standards/issues/8
These were discussed out in the open, and meaningful feedback, suggestions, or pull requests are certainly welcome.
[1] https://github.com/18F/api-standards/blame/master/README.md
[2] https://github.com/WhiteHouse/api-standards
[3] http://18fblog.tumblr.com/post/91868213233/hot-off-the-press...