HN user

roguelynn

418 karma

Engineer at Spotify. Founder of SF chapter of PyLadies. http://roguelynn.com

[ my public key: https://keybase.io/roguelynn; my proof: https://keybase.io/roguelynn/sigs/jKMBdneDn7sZaN3LRfoYDlj2OiLX7FQUSENDs6efS7k ]

Posts9
Comments13
View on HN

Currently this is just Wordpress, but we are (at some point, not when) moving to a static HTML generator. I'm not close to the doc generation/writing, so I don't know too much.

I wrote a Python parser for this called RAMLfications (https://ramlfications.readthedocs.org/en/latest/)

I actually built the API console for my company - Spotify (https://developer.spotify.com/web-api/console/) - based off of RAML and am in the process of open sourcing the tech behind it. The first bit being RAMLfications, and the second, called Griffin (https://github.com/spotify/griffin) is a super alpha version of a static doc generator based off of RAML. The next/last bit to open source is the console itself, as well as some integrations like Flask extensions/Django packages.

"We have created this diversity statement because we believe that a diverse Python community is stronger and more vibrant. A diverse community where people treat each other with respect has more potential contributors and more sources for ideas."

Source: http://www.python.org/community/diversity/

Universal Design, the idea that produces "buildings, products and environments that are inherently accessible to both people without disabilities and people with disabilities" is the same idea when in the context of diversity in programming: http://en.wikipedia.org/wiki/Universal_design

Think about it, if Apple had a woman's input, do you think it'd be named iPad?!? For f*ck sake, it's the most ridiculous name ever, reminding half the population of the embarrassing trip to the drug store.

Plenty more on Diversity just within Python: http://wiki.python.org/moin/DiversityInPython