A Preview of the Conference I’ve Been Planning for the Last Year

pydx-color-logo-blue

I’ve been working on PyDX for over a year. So have my phenomenal co-organizers, Rachel Kelly, Georgia Reh, Melissa Chavez, and Christopher Swenson. This weekend — October 10th and 11th — all of that hard work is going to pay off.

PyDX, by the way, is a community conference for Python programmers in the Pacific Northwest.

Our Schedule Rocks

I’ve already said that I sort of wish I wasn’t organizing PyDX, because I want to attend it. We’re filming all of the talks, in part because I would cry if I didn’t get to hear at least a few. Here are the talks that I’m particularly thrilled about:

  • Melissa Lewis’ keynote (Saturday AM) — I’ve had the pleasure of hearing Meli speak at PyLadies events and she is going to blow away the PyDX crowd.
  • Terian Koscik’s Build a Bot workshop (Saturday AM) — Terian has an impressive array of Twitter bots that do some cool tricks. She inspired me to start working on my own Twitter bot, but I need some help (I’ll probably watch the video of this talk repeatedly).
  • Evan Palmer’s Making MIDI Music with Python talk — I admit that I actually got to hear Evan practice this talk, but I’m still excited for the final version. He’s making music programmatically!

You can see the whole schedule here as a PDF. I’m biased, of course, but I think we’ve got a great line up across the board.

I’m incredibly grateful to our speakers for putting in proposals and agreeing to speak at PyDX. Many are traveling to Portland on their own dime to do so and I’m a little in awe of the group of people we’re bringing together.

A Conference for Everyone

One of our commitments from the start of organizing this thing was to create a welcoming conference where everyone feels comfortable. Every PyDX organizer has been to tech conferences where we’ve felt like we don’t belong and we’re willing to go to extreme lengths to avoid anyone feeling that way this weekend. A lot of these decisions, by the way, didn’t take all that much time or money to implement.

A Dry Conference: Tech conferences tend to be boozefests, even though many people either don’t drink at all or would prefer not to drink around people they know professionally. So we’re not providing alcohol as part of the conference (though attendees are welcome to meet up after hours for drinks if that’s their thing).

A Code of Conduct: I’ve reached the point where I just won’t deal with events and organizations that don’t have a code of conduct (as well as a way to enforce their CoC). It’s a matter of safety.

Scholarships: Our tickets are priced at $100, which isn’t cheap. The value is more than there (especially when you consider we’re providing food, childcare, great speakers, and more) but we are aware that it’s out of reach for many of the people who might benefit from attending PyDX. So we’re offering scholarships. And if you want to sponsor someone else’s scholarship, you can sponsor for any amount through this payment form. A full scholarship costs us $200 to provide, because we offer stipends for travel and other expenses, depending on the recipient’s need.

We had a good business case for diversity, by the way, which helped us explain the importance of these steps when fundraising and marketing. PyCon North America is taking place in Portland in 2016. We’re making sure that anyone who is considering learning Python before that point has an easy way to get started and to join the local community (which desperately needs more programmers).

Plenty of Pythonic Personality

Community conferences are great because they have more personality. When a conference hosts several thousand attendees, everything has to run like a well-oiled machine. But since PyDX is a smaller community conference, we can have a little fun.

Our entire vibe is a weird mix of hipster jokes and Monty Python references. I’m still not sure I’ve found all the jokes on our website, but I did have a great time writing our sponsorship prospectus (I did have to spend some time researching synonyms for ‘artisanal’).

And I’ve dared the community to help us sell out. If we sell out of tickets (and yes, scholarships count), I’m going to get the PyDX logo (the snake at the top of this post!) as a tattoo. I was originally threatening to get that tattoo on my butt. However, since I want to be able to show it off without violating the code of conduct, I’m thinking my leg is a better bet. Last time I checked, we still needed to sell about 40 tickets for me to get that tattoo. Want to make it happen? Buy a ticket (use FRIENDOFPYDX for 10% off) or sponsor a scholarship (same payment form as before). You know you want to see me all inked up.

 

One Weekend, One App

friendshipapi logo

Over the weekend, my husband and I put together FriendshipAPI.com. He did all the coding, while I wrote copy, designed a logo, and did a little bit of marketing. Christopher wrote up the technical side of launching an app in one weekend, so I figured a rundown of how I spent my time would be useful as well.

The Overall Goal

I saw a contest last week for creating apps based on Context.io’s API (which is especially good at analyzing big chunks of email). We decided to see what we could come up with on short notice; luckily, we already had a few ideas in the pipeline. Christopher and I have talked about how to stay in better touch with some of our friends, especially since we’ve moved cross-country a few times.

Because we were building Friendship API as a contest entry, rather than a business that we expect to be quickly self-sustaining, our goals were:

  • create an app that functions correctly
  • make an attractive site that showcases the app
  • get a little traffic to the site (mostly to get people to test out the app)

Getting more traffic might be nice, because the contest does have an award specifically for whoever grows their traffic the most. But, honestly, too much traffic would be a pain in the posterior for us because the app is running on Heroku’s free plan. If we actually got a serious number of visitors, we’d have to pay for a better plan.

A Full-Fledged Web App

Building a web app requires a fair amount of work, but just writing code is not enough. This is a big pet peeve of mine: hackathons, school projects, and all the other various quickie apps you might write have the same crappy look.

And before anyone tries to tell me that a weekend is too short a period of time to put together a design, let me tell you what we did: we bought a design from ThemeForest — this one, in fact. Starting from scratch on a design is tough in this short a timespan (although not impossible if you actually have access to a designer). But modifying an existing design is pretty doable.

If you do have some design skills and trying to move fast, I always recommend putting together three creative assets first off:

  1. A color palette
  2. A set of typefaces
  3. A logo

You can polish up an existing design quickly if you know what colors and typefaces you want to use and if you have a logo to add to the design. Super short on time? Use a typeface you don’t plan to use anywhere else on your website to make a text-only logo of your app’s name.

Friendship API is done in blues and gray; I used the blue built into the design already and added a darker shade for the logo and some design elements.

The logo is set in Unica One, which is available under an open license through Google Web Fonts.

A Quick Bit of Marketing

The real goal of our marketing Friendship API was to get some feedback on what we were doing: a weekend isn’t long enough to do real UX testing, but you can get people to tell you what they don’t like about your app through Twitter.

We were specifically looking for the sorts of people who will be judging the contest: startup nerds. That informed where we put our energy.

Our marketing plan broke down like this:

Twitter: I created a Twitter account for the site (mostly for tracking purposes on Twitter) and tweeted about the launch on the day of. I retweeted that tweet, along with writing a couple of original tweets for my account and my husband’s.

Blog: We launched with two blog posts — one on my husband’s site and one on Medium. I was able to write tweets about the blog posts, as well as share them on sites like Hacker News.

Private Channels: I wrote a couple of short messages to post on a few different private channels I have access to (Facebook groups, Slack teams, and the like).

We got about 100 visitors in the first day. Just like every other time I’ve launched a project, private channels brought us the most traffic — over two-thirds. Twitter came in a distant second.

We also got quite a bit of feedback, which is exactly what we were hoping for. We were able to make a couple of crucial adjustments before sending in our contest entry.

My Template for Technical Resumes

Offline, I spend a lot of time helping friends with their resumes. I’ve even given a couple of workshops about technical resumes.

This is the template I use in helping someone get started in creating a technical resume:

You can also access the document here. You may notice a lot of comments in this particular document — I’ve laid out the logic and options for each section in the file so that anyone using it doesn’t have to refer to anywhere else. With that in mind, I strongly recommend copying the file to your own Google Drive and then editing that copy.

HTML is the New Latin

html

Latin is a strange language. No one speaks it as their first language and few people speak it regularly outside of Vatican City. Yet many schools still offer Latin classes and most of us know a few words (even if we aren’t always aware that we do). We still use Latin roots for forming new words, even in English with its Germanic heritage. Kids studying for the SAT or GRE learn Latin roots to score well on what may be the most important tests of their lives.

We have a certain respect for the language that united scholars and politicians across Europe hundreds of years ago. Latin provided an underlying structure that allowed key ideas to pass communication barriers. Whether or not Latin is regularly spoken in the future, it will still have a lasting impact on the words we use for centuries to come.

The digital age requires a new connective infrastructure. Markup languages, including HTML, are that communication tool. Markup languages are systems of annotating documents in a way that’s both visually different from the text itself and recognizable by computer programs. Learning at least a few HTML tags is rapidly becoming a necessary step to sharing information across borders. HTML, by the way, stands for “HyperText Markup Language.”

The Words Themselves Aren’t So Important Today

As a writer, I hate myself for even suggesting that words themselves aren’t so important. But with translation tools constantly improving, my choice to use English words is far less important than it was even a few years ago. Even the specific words I use are exchangeable for something simpler: I can drop a blog post like this into Hemingway and see where I can change my diction.

I read web pages written in foreign languages every day. Google translates those pages for me automatically. I don’t need a human to translate their work into Latin or another shared language for me to get the gist of it.

But I do need those foreign texts in a format that Google can access. They need to be web pages, written in HTML, so that a machine can access and process the information they contain. Markup languages make our work accessible to the world — the same purpose Latin served centuries ago.

Of course, machine-based translation isn’t perfect. It’s improving, however, especially as the systems handling such translation get access to more text and can learn from experience. The algorithms used to process language are improving every day. In the long-term, it’s possible that we really could have real-time translations whispered into our ears as we talk. In the meanwhile, we can make our work easier to access, both by machines and by humans.

A Little Formatting Makes a World of Difference

Formatting is crucial. When we speak, we can convey our emotions through eye rolls, upbeat tones of voice, and other non-verbal communication. But with the written word, we’re limited to sharing information through words and formatting. Boldness, bullet points, and other visual cues have to do the heavy lifting.

This sort of formatting also conveys information to non-human readers. When a machine processes a document without any formatting, it can guess what the title and topic of the piece are based on comparison to other documents. But if the writer of a document puts a couple of H1 tags around that document’s title, a computer can tell the title of the piece immediately. Doing so also helps human readers focus on the title quickly, as an added benefit.

Unfortunately, formatting isn’t always a simple matter. There are many ways we can share text with the world — a shared Word doc, a WordPress blog post, a plain text comment, and many more. But each of these methods brings its own formatting woes. Our reliance on rich text is to blame. Different tools implement formatting in different ways, making it difficult to copy and paste between systems. These proprietary systems don’t talk to each other as well as they could. Don’t get me wrong. The situation has improved over the past few years: You can copy text from a Microsoft Word document into a WordPress blog post without your formatting going all wonky now (provided you’re using a recent version of WordPress). But there’s still plenty of room for improvement.

Writers Need to Learn Markup Languages

The need to make our work more accessible for both human and machine readers seems like a question of improving technology. Our tools are continuing to evolve. But, as a writer, choosing to learn HTML or another markup language can push your own work much further.

On the most basic level, offering an editor or a publisher a plain text file formatted with HTML can help your career. An editor can get your work published online far faster if you hand them a prepared file. You have a far better shot at being the editor’s favorite writer when you know HTML.

On a deeper level, however, the ability to correctly format your writing in HTML can increase its reach. Search engines have a harder time ranking an incorrectly formatted blog post or web page than one with correctly written HTML. You don’t have to dive too far down the rabbit hole: just being able to format your writing and add a little meta data is enough to make your work much more accessible. Adding in the right HTML is the modern day version of translating your work into Latin so that the folks in the next country over can actually find and understand your work in their library.

I’m not suggesting that you learn how to program. I may personally think that’s a good idea, but I’ve seen other writers get anxious at that sort of suggestion. Rather, writers need to be able to annotate our work to ensure our meanings are clear — we need to add formatting tags and a few other details. It’s possible to get by with using a tool that generates your HTML for you. I actually write in Markdown using a cloud-based word processor that can transform Markdown files into all sorts of other formats. But it’s worth your while to learn some HTML first, if only so you’ll notice if an automated system gets something wrong.

HTML is a Tool of the Cultural Elite

Through the seventeenth century, getting any attention at all required translating your work into Latin. It didn’t matter if you were a member of the Catholic Church or not. Latin was your only choice of languages for communicating with the cultural elite. Even Isaac Newton, who lived in the Protestant country of England, wrote his mathematical treatises in Latin.

Today, reaching the cultural elite means publishing your work online. Online doesn’t mean just tossing up an essay or an article on your blog, by the way. If you want to have any sort of reach, you need to be able to push your work on to a variety of platforms, like the Kindle. Just as writing in Latin meant that any European with a good education could read Newton’s work, marking up your own work with HTML makes spreading it easier. You can immediately push your work out to all the different platforms your readers might use. (The only way to use what Amazon refers to as ‘advanced formatting’ in a Kindle ebook, as it happens, is to format your book using HTML.)

There may always be print versions of particular work, but we’re fast reaching a point where publishers of all stripes push work online first and create a physical copy second. And since HTML, with a little help from CSS, can format text for printing, we should expect the online-first mindset to become even more common.

So Where Should Writers Start?

It’s not uncommon to meet writers who are only interested in perfecting their craft. Personally, I find that mindset to be problematic: If you want to lock yourself in a room all day to write, how can you guarantee that anyone will ever read what you’ve created? If you want to opt out of the world and focus on writing to the exclusion of all other things, though, you do have the option.

But if you’d rather ensure your work reaches an audience, there are a few easy starting points to help you learn a markup language.

  • Start by writing in a rich text editor, such as the one built into WordPress. Write as you would normally, but make a point of switching from rich text to HTML. In WordPress, you just need to click between tabs at the top of the text box where you’re composing your latest magnum opus. Once you see your HTML, you can make a point of checking your formatting against the HTML your editor generates. You’ll pick up simpler formatting, like bold or italic quickly.
  • Consider going through a tutorial or a class. There are hundreds of free tutorials online for HTML and related topics. I’d suggest searching for how to handle specific questions, like ‘how to format a block quote in HTML‘. You can also take more in-depth classes, like those offered by Codecademy.
  • Learn more about markup languages — but only if you really want to. I realize that I’m already bumping up against the limits of what the average writer cares about by writing 2,000 words about why you should care about HTML. If I went down the rabbit hole into topics like metadata, Markdown, and the wide variety of markup languages out in the world, I’d probably lose most of you who have read this far. But for the one or two of you who have an interest, there are all sorts of opportunities out there for writers who really understand markup languages.

You can also consider your tools. We don’t always get the option of choosing how we write. The muse may only strike when you’re looking at an entirely blank screen or even if you’ve just got a pad of paper and a pen. But if you understand your own workflow, you may be able to upgrade your tools so that you’re able to deal with HTML questions and the like with only minimal effort.

At the bare minimum, choose word processing programs capable of exporting HTML without screwing up your carefully planned formatting. Scrivener, for instance, has a much better export track record than Microsoft Word. There are any number of word processors and other tools that will help you write, as well as add HTML to your work in an efficient manner.

Right now, I’m using a tool called Beegit. It gives me a way to share projects with a team, as well as the ability to write with visible markup in my documents. However, Beegit is based on Markdown, rather than HTML, so it’s not necessarily a good switch if you’re still learning about markup languages.

Your Obligation to Experiment

The written word is becoming ever more important: We spend more time with text today than any of our ancestors ever did. But we still haven’t perfected a way of ensuring that a given document is accessible to every single person who wants to read it. Language and cultural barriers still slow down how quickly we can share new ideas, as does issues as simple as file formats.

But the more that we writers can tackle the question of accessibility on our own, the wider our own work will spread. If reaching readers is one of the reasons you bother to put words into a row, take the time to experiment with markup languages, just scholars in centuries past invested the time necessary to learn Latin.

Photo credit: iStylr

A Pioneer Nation Follow Up

I spent a few days at Pioneer Nation, a small conference geared towards entrepreneurs here in Portland. I heard a few comments over and over again, to the point that I wanted to bring them to your attention:

It’s so amazing to talk to people who get what I’m going through. My family just doesn’t understand.

Being willing to make the leap into running your own business isn’t easy. Even if no one in your family is ready to jump off that sort of cliff with you, t’s crucial to find a community of support — hopefully with people who you can talk to on a regular basis, rather than once a year. Going it alone isn’t impossible, but if you’re going to do something as demanding as starting a new business, why make the process harder?

I know what I need to do. I’m just having trouble doing it.

I’m pretty sure that this is an ongoing problem for most entrepreneurs; I know it’s something I suffer from on a regular basis. For most of us, the next step is pretty obvious: Maybe we need to launch a product, send a proposal, or set up a marketing campaign but we haven’t. Part of the problem is usually finding the time. It’s a legitimate problem, by the way — there is a hard limit on how many hours you can work in a day. But part of the problem is often that we’re a little afraid to move forward, especially if we feel overwhelmed by the successes we’ve already had. I don’t have a solution for this problem, except to power on through whenever you have a rush to move forward. Just do as much as you can, when you can.

I have to think bigger!

In my line of work, I have to tell a lot of my clients that they need to think a little smaller — that their budgets won’t support the high-minded plans they’ve been making. But at Pioneer Nation, several people told me that they’d realized they need to think bigger. Part of that may have been the audience; it included a lot of people who were shooting for businesses that would first and foremost support their lives. But part of that is also that it’s tempting to focus on what we know we can accomplish with the resources we currently have, and let the big opportunities pass us by. But it’s good to think big and chase goals that seem a little audacious. Otherwise, we can’t tell what we’re capable of.

Pioneer Nation was a great conference, both to present at and attend. I just want to take a moment here to thank Chris Guillebeau and the legions of folks involved in putting Pioneer Nation on. Great job! I look forward to seeing where you take it next year!

You Never Know What Will Happen to the Work You Send Out Into the World

Quite a while ago, I wrote an article about web typography, “10 Web Typography Rules Every Designer Should Know, for WebDesignerDepot.com. To be frank, I’d forgotten about the article for the most part — while it’s a topic near and dear to my heart, it’s not one that I’ve written about recently.

But a few months ago, I got a pleasant surprise. A student studying web design in Australia emailed me, explaining that she had used the article in a design project. Not only that, her whole class had received the same assignment, using my article for the basis of a layout.

It’s a funny feeling, knowing that something I wrote is used in educational materials. A mostly good kind of funny — partially curiosity about how my article was chosen, but also partially that feeling you get when you hold a new baby and wonder if you’re going to absolutely screw up the poor kid’s future.

Image courtesy Celeste Watson, a graphic design student who I am sure we’ll hear great things about soon.

An Accidental Talk: ‘Blogging for Dollars’ at Bar Camp San Diego

I flew out to San Diego last Friday to see my husband, who happens to be working out here this summer. I found out that BarCamp San Diego was Saturday and Sunday — I’m a fan of BarCamps and other small sort-of conferences because they’re almost always free and you get to hear from a lot of people who are truly passionate about the projects they’re working on. This weekend was no different… but I wound up giving a talk myself.

If you aren’t familiar with the BarCamp format, it’s pretty spur of the moment: all the attendees show up about an hour before talks are scheduled to start and hash out the day’s speakers. Before that point, no one really knows who will be speaking and what they’ll be talking about, and that can include the speakers. As people were hanging out and chatting, I wound up on one of my standard soap boxes — making money off of writing online. If you do that at a BarCamp, you quickly wind up on the schedule.

That meant, between the next few sessions, I had to distill my soap box down into about 30 minutes of coherent presentation. I’ve included my notes below, but I simply wound up focusing on giving a broad overview on how a blogger can make money, mentioned a few key bloggers who are good role models and then offered about ten minutes for questions about the specifics people were wondering about.

Five Things to Do Before Trying to Make Money as a Blogger

  1. Use WordPress. Furthermore, get your own domain name and host it yourself. Sure, there are other blogging tools out there, but WordPress is the horse I’m betting on. It’s more robust, has a bigger community of developers and the user interface is very friendly for new bloggers.
  2. Look for money-making opportunities, besides advertising. It’s hard to make a living off of AdSense and it’s getting harder. Most other approaches to advertising require you to have a lot more traffic than you will when you’re starting out.
  3. Network with the other bloggers covering your topic. Having a network is crucial to making money, even if it’s only a matter of discussing a product idea with a friend who can say ‘I tried that and it didn’t work so well.’
  4. Listen to your readers. Maybe your readership is ten of your closest friends and your mom. Assuming your mom is only there to be supportive, your friends can still give you a good idea of what you’re doing well and where you can improve. As you grow, keep listening: ask readers questions, especially about what they’d be willing to buy from you.
  5. Write as much as you can. Even if you don’t consider yourself a fabulous writer, you have to write as much as possible. The practice will make you a better writer, which is an absolute necessity for a career as a blogger.

Five Strategies to Make Money Blogging

  1. Set yourself up as an expert and sell consulting services or freelance services
  2. Use your blog as a portfolio and land paid blogging gigs on other websites
  3. Sell information products (like ebooks or webinars) related to your blog
  4. Sell physical products related to your blog (like t-shirts, cookware or whatever your niche is)
  5. Use affiliate links to promote other companies products

This is just a smattering of options, of course. There are plenty more. But these are the big ones — the ones that absolutely have to be covered when you’re limited to thirty minutes of chatting. I think it’s worth noting that that these five methods all fall into one of two categories of making money from blogging, as do all the alternatives: indirect and direct income. Direct income comes from advertising, selling a product and so on, while indirect income comes from establishing your expertise and using it to land bigger gigs (such as consulting or writing).

I think two bloggers really typify the difference: Darren Rowse and Chris Brogan. Chris has built a whole company around his expertise and the expertise of the people he works with, earning a nice chunk of change from consulting and speaking gigs. Darren has also built up a company, but he’s focused more on ebooks, membership sites and more directly selling to his readership. There is some overlap between what they do, of course. Both of these bloggers are immensely successful, though, and make for wonderful blogging role models.