Skip to content

Commit

Permalink
fixed 'work' page, added posts maytime so far, learn together
Browse files Browse the repository at this point in the history
  • Loading branch information
danswick committed May 4, 2015
1 parent 5a4440d commit 1f800a1
Show file tree
Hide file tree
Showing 16 changed files with 145 additions and 104 deletions.
3 changes: 2 additions & 1 deletion _config.yml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Dependencies
markdown: kramdown
highlighter: rouge
highlighter: pygments
kramdown:
input: GFM

Expand All @@ -22,6 +22,7 @@ pages_list:
Words: 'words/index.html'
Projects: 'work/index.html'
Feed: 'atom.xml'
category-list: [Projects] # can expand to include more categories as they are added

# Custom vars
version: 1.0.0
Expand Down
4 changes: 2 additions & 2 deletions _layouts/post.html
Original file line number Diff line number Diff line change
Expand Up @@ -3,8 +3,8 @@
---

<div class="post">
<h1 class="post-title">{{ post.title }}</h1>
<span class="post-date">{{ post.date }}</span>
<h1 class="post-title">{{ page.title }}</h1>
<span class="post-date">{{ page.date | date_to_string }}</span>
{{ content }}
</div>

Expand Down
14 changes: 7 additions & 7 deletions _posts/2014-6-27-setup.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ layout: post
title: Jekyll for WYSIWYG'ers
---

##Why Jekyll and this whole static sites business?
## Why Jekyll and this whole static sites business?

About a year ago, a sweet hosting deal I'd managed to finagle fell through and my modest personal website needed a place to live. I'd been using Wordpress for years and had become fairly familiar with its workflows and quirks. Between my personal writing and work-related writing, I've probably set up a dozen Wordpress sites over the years, but never really got past the official installer scripts, WYSIWYG editors and, occasionally, small php edits here and there.

Expand All @@ -19,7 +19,7 @@ I just want to point something out that sort of escaped me when I was looking in

There are many thousands of words all over the web explaining how to set up Jekyll, so I'll refrain from spelling out the whole process (see the resources section at the end for some helpful links) and instead just outline some of the barriers I encountered and how I overcame them.

##Getting Jekyll running locally on OS X
## Getting Jekyll running locally on OS X

Before you dive into the Jekyll hot tub, be sure you understand that you'll need to do some work in the terminal and if you're new to this type of thing, it's probably going to get messy. But *that's okay!* You (probably) won't break anything beyond repair and you'll learn a lot in the process. The [official Jekyll docs](http://jekyllrb.com/docs/installation/) are essential, but there are some other great guides out there as well.

Expand All @@ -36,28 +36,28 @@ Stuff you should install on your mac:
- Homebrew
- Jekyll!

###Mavericks is a pain
### Mavericks is a pain

I foolishly updated OS X right in the middle of trying to wrap my head around Jekyll and encountered all kinds of issues that are addressed in [this article](http://hackercodex.com/guide/mac-osx-mavericks-10.9-configuration/) about configuring Mavericks. It covers some basic stuff like un-hiding your library folder, fixing your `PATH` (read the comments to get a broader view on PATH issues) and setting up [Homebrew](http://brew.sh/).

###System Ruby
### System Ruby

I had a lot of problems with Ruby, which all seemed to trace back to the pre-installed version of Ruby that comes with Mavericks. I'm no Ruby expert, but it's much easier to work through Ruby Version Manager rather than deal with the [many issues](http://robots.thoughtbot.com/psa-do-not-use-system-ruby) that come from working with pre-installed Ruby. Do yourself a favor and set up [Bundler](http://bundler.io/) and [RVM](http://rvm.io/) before diving into Jekyll.


##Configuring a custom domain registered through GoDaddy
## Configuring a custom domain registered through GoDaddy

This step has actually gotten a bit more transparent in the months since I set my site up. [This official GitHub help doc](https://help.github.com/articles/tips-for-configuring-an-a-record-with-your-dns-provider) should actually provide all of the information you'll need, but if you're unfamiliar with GoDaddy's DNS settings panel, [this guide](https://medium.com/@LovettLovett/github-pages-godaddy-f0318c2f25a) has a lot of helpful screenshots, though the author only sets up one `A` record. You'll need the two listed in the previously mentioned official help doc.

> **TIP:** You might run into some documentation that mentions setting up a `gh-pages` repo. This refers specifically to Project Pages. If you're setting up a User Page, you should ignore references to `gh-pages`.
##Understanding templates and theming
## Understanding templates and theming

Reading through the Jekyll documentation, I felt like I had a fairly strong understanding of the mechanics behind Jekyll's template system, but had a hard time making it work in practice. I really wanted to hand-code everything, but ended up settling on a simple pre-built template. One of my goals is to build my chops a bit and so far I think tweaking a simple existing template is the right choice. Jekyll is transparent enough that I can get a good sense for how everything works, save myself a lot of headache and easily make some deeper changes to the templates.

I am currently using [Poole](https://github.com/poole/poole), which includes everything you need to get started poking around Jekyll. The author, [Mark Otto](https://github.com/mdo), has done a great job laying out documentation and building clear examples. [Joshua Lande](http://joshualande.com/jekyll-github-pages-poole/) has posted a really nice guide to working with Poole as well.

##Resources
## Resources

- ["SEO" with site maps](https://help.github.com/articles/sitemaps-for-github-pages)
- I also didn't quite understand how to add `jekyll-sitemap` to my `_config.yml` file. It should look like this:
Expand Down
21 changes: 10 additions & 11 deletions _drafts/learn-together.md → _posts/2014-7-3-learn-together.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,39 +3,38 @@ layout: post
title: Learn Together
---

Over the last couple of years I've had this nagging feeling, a bit like standing on the very edge of the tech community looking in, unsure if or where I fit in. I know that I want to be on the inside, but it hasn't always been clear why. Maybe a sense of inertia or curiosity or the lure of greater employability. Probably a little of each, but I think the biggest factor has to do with the desire to know something more completely. In this case, the "something" is technology, both in the computers/internet/software sense and also in the more meta, "how does technology influence society/the environment/art/etc?" sense. To be so inundated by and reliant on technology without a deep sense of understanding feels wrong, incomplete, and perhaps a little irresponsible, especially since a core element of my career has involved using technology to help communities solve problems.

Over the last couple of years I've had this nagging feeling, a bit like standing on the very edge of the tech community looking in, unsure if or where I fit in. I know that I want to be on the inside, but it hasn't always been clear why. Maybe a sense of inertia (likely an artifact of modern academics) or curiosity or the lure of greater employability? Probably a little of each, but I think the biggest factor has to do with the desire to know something more completely. In this case, the "something" is technology, both in the computers/internet/software sense and also in the more meta, "how does technology influence society/the environment/art/etc?" sense. To be so inundated by and reliant on technology without a deep sense of understanding feels wrong, incomplete, and perhaps a little irresponsible, especially since a core element of my career has involved using technology to help communities solve problems.
So, whether through conscious effort or awkward stumbling, I've started amassing knowledge. I'm not just interested in learning how to code in a specific language, though that is certainly among my interests. Rather, because my learning style generally follows a 'wide-net' approach, I want to better understand the *communities* surrounding tech, the *culture* of open source, the greater industry's big issues and how, if at all, I can make tech jive with my other professional interests. To that end, I've spent a lot of time reading - blogs, twitter topics, GitHub issues, etc. Trying to learn to code on your own is lonely and business and I often find myself wishing for a social outlet, if only to ask questions, share stories or just say, "hey, I got this thing to work!" It's also the kind of endeavor that, despite all the fancy new tools welcoming newcomers, feels more overwhelmingly huge the farther you dig ([relevant](http://matt.might.net/articles/phd-school-in-pictures/)).

So, whether through conscious effort or awkward stumbling, I've started amassing knowledge. I'm not just interested in learning how to code in a specific language, though that is certainly among my interests. Rather, because learning style generally follows a 'wide-net' approach, I want to better understand the *communities* surrounding tech, the *culture* of open source, the greater industry's big issues and how, if at all, I can make tech jive with my other professional interests. To that end, I've spent a lot of time reading - blogs, twitter topics, GitHub issues, etc. Trying to learn to code on your own is lonely and business and I often find myself wishing for a social outlet, if only to ask questions, share stories or just say, "hey, I got this thing to work!" It's also the kind of endeavor that, despite all the fancy new tools welcoming newcomers, feels more overwhelmingly huge the farther you dig ([relevant](http://matt.might.net/articles/phd-school-in-pictures/)).
## The lonely road

##The long and lonely road
If you spend any amount of time digging through Quora threads on beginning programming, especially if those threads have anything to do with coding bootcamps, it's easy get the sense that all great developers have honed their crafts alone, putting their noses to the grindstone during every spare moment. I'm certain this is true for many developers, but if the industry is to change perceptions and welcome a greater diversity of people, this lone programmer mythology will probably have to evolve. I'm no stranger to learning on my own, making mistakes or cursing out loud at my computer in an empty apartment, but have found that I can only get so far on any given topic before I need to consult other human beings, and I suspect a lot of people feel the same way.

If you spend any amount of time digging through Quora threads on beginning programming, especially if those threads have anything to do with coding bootcamps, it's easily get the sense that all great developers have honed their crafts alone, putting their noses to the grindstone during every spare moment. I'm certain this is true for many developers, but if the industry is to chance perceptions and welcome a greater diversity of people, this lone programmer mythology will probably have to evolve. I'm no stranger to learning on my own, making mistakes or cursing out loud at my computer in an empty apartment, but have found that I can only get so far on any given topic before I need to consult other human beings, and I suspect a lot of people feel the same way.

##The geo people
## The geo people

My tie to tech has always been my work focus on geospatial technology. My work involves analyzing all manner of geo data, creating map products for publication and figuring out how to help communities and organizations put their data to use solving one problem or another. While it's certainly a valuable tool, one can only go so far as an [ArcGIS](http://www.esri.com/software/arcgis) user before feeling like little more than an expert fixer of ArcGIS-specific bugs. To make matters worse, without a moderate comfort level in programming, official help docs can be quite intimidating and, due to sweeping changes between versions (backward compatibility would be nice, guys), may lead users down a dead end road to frustration-ville.

In my experience, most ArcGIS users became ArcGIS users in college, where academic software deals have made ESRI's suite of products the de facto choice for making any kind of geospatial product. However, with unofficial support forums like [gis.stackexchange.com](http://gis.stackexchange.com/) popping up, it's becoming impossible to ignore the huge and vibrant world of open-source, web-friendly products and, perhaps more importantly, their respective communities. These days, you can't go to a GIS users group, even those oriented to ArcGIS in particular, without hearing about [Leaflet](http://leafletjs.com/), [OpenStreetMap](http://www.openstreetmap.org/#map=5/51.500/-0.100) or [MapBox/TileMill](https://www.mapbox.com/tilemill/), and for good reason. A small army of dedicated volunteers, companies and organizations have done what ESRI couldn't, not just by building better tools, but by building a community for themselves and leaving the door open behind them.

As I've started following the open-source geo community, contributing where I can, I've inadvertently started developing some of the tech acumen I'd been looking for. Most projects have active GitHub communities (hi, [Maptime](https://github.com/maptime)!), some have beautifully-written [guides](https://www.mapbox.com/foundations/), and others have totally accessible and beginner-friendly [conferences](http://stateofthemap.us/). Central members are active and responsive on Twitter and there are new and innovative meetups popping up all over the place.

##Business time
## Business time

This spring, I found myself with a bunch of extra vacation and frustrated at my slow pace of learning on my own. A reminder about the upcoming [State of the Map](http://stateofthemap.us/) conference popped up on Twitter and I decided to go. Even if I couldn't find a way to tie it into my professional development schedule at work, it seemed like a pretty casual and social conference and hey, spring time in D.C. is nothing to sneeze at. E and I threw down on some plane tickets and started planning for a nice, long weekend out of town.

If I'm being completely honest, the first two days of the conference were kind of awkward. I didn't know anyone, there seemed to be a lot of community norms I didn't understand and I didn't feel like I had anything to contribute. I've never been particularly active on OpenStreetMap (though that's changing) and I'm not a developer, so it was tough initiating conversations. One the second day of the conference, I found myself at a lunch table with a bunch of computer scientists, just listening in, when somebody mentioned their work using geo data for an urban planning project. We introduced ourselves, started geeking out about planner-y things (stakeholders! prioritizing!) and promptly spooked our computer scientist friends away from the table. My new friend introduced me to some other beginners and recommended some social conference activities.
If I'm being completely honest, the first two days of the conference were kind of awkward. I didn't know anyone, there seemed to be a lot of community norms I didn't understand and I didn't feel like I had anything to contribute. I've never been particularly active on OpenStreetMap (though that's changing) and I'm not a developer, so it was tough initiating conversations. On the second day of the conference, I found myself at a lunch table with a bunch of computer scientists, just listening in, when somebody mentioned their work using geo data for an urban planning project. We introduced ourselves, started geeking out about planner-y things (stakeholders! prioritizing!) and promptly spooked our computer scientist friends away from the table. My new friend introduced me to some other beginners and recommended some social conference activities.

The rest of the conference was fantastic. I got to meet and speak with people who's work I've been following closely for years, have drinks with the people building the future of geospatial, and got myself involved with some truly innovative projects. It's something we all forget, especially those of us who spend most of our waking hours in front of a screen, but sometimes being in a room with like-minded people is what it takes to accelerate one's work. Shared experience and communities of practice put work into a social context and reinforce the reasons we do our work in the first place. Are you motivated by building cool new tools? Who is going to use your tools? Do you want to make a social impact? There are people just like you pushing toward similar goals - how can you learn from one another?

##Open source communities
## Open source communities

I've been a longtime advocate of open source software, but I'm not sure I've always understood why. My best guess is that it's a mix of vague feelings of democracy mixed with an aversion to large, monolithic corporations. Probably not the best reasons to advocate for something.

What I came away with after State of the Map, besides a ton of notes and new Twitter friends, is a better understanding of what this whole open source thing is all about. Yeah, it's about things like licenses, pull requests and free (as in both beer and speech) software. But I don't think that's all, or even most of the story. I think people contribute because of the community. Because they want to help build something better and because doing so together builds a sense of community and belonging. I'm drawn to the ideals of the burgeoning open data community because of the impact it promises. I believe open data can deliver on its promises, but ultimately, I participate not for the data's sake, but for my community.

The best projects, whether they set out to [democratize the globe](www.openstreetmap.org), [turn vacant lots in community open space](http://neighbor-space.org/) or [push the boundaries of social interaction online](http://www.zefrank.com/theshow/), understand and respond to their communities. Sometimes it's a conscious effort and other times it's just the result of a particular kind of attitude or personality.

realization that, even in the age of the internet, relationships, friendships and social interactions are critical to learning, progressing, making an impact.
## Bringing it all together

what i'm doing differently - maptime, intra-office workshops, letting go of my topic turf and stepping back. works in the office, in friendships and relationships, sports, etc.
I'm continuing to learn more about the people, organizations and ideas the drive the technology that makes my work and life possible. Some days, the slog of learning alone is hard to overcome. Other days, I remember that I'm surrounded by phenomenal communities, some [local](http://opengovhacknight.org/) and some [international](http://hotosm.org/) who've all overcome these things before and are dedicated to bringing others into the fold. Over the next year, I hope to dig in deeper, share some knowledge of my own, and hopefully give back a bit of what I've gained.
Loading

0 comments on commit 1f800a1

Please sign in to comment.