I'm Matthew Setter. I'm an experienced software engineer and a security researcher. I’ve been developing software since 2000 and I started this blog to help you write simpler, cleaner, and more secure software, with less effort.
Be a Develope's Friend - and Grow Your Businesswriting April 1st, 2014
You may have the best platform in the world, unmatched by anyone else. But is it easy for developers to use?
You may have the best platform in the world, providing the world’s greatest security or performance, to a level unmatched by anyone else. But will developers use it?
If it’s unclear, opaque, or the learning curve’s too steep, your platform will be assigned to the “too hard” basket. Developers will leave in search of one which is clearer, one which involves less work to understand and use. Don’t let this be your platform.
If there’s one thing developers need – it’s documentation. Whilst most of us are intelligent, experienced and engaged people, passionate about our craft, sometimes to a fault, very few of us are geniuses, very few of us can infer what we need from source code alone.
Libraries and Systems Aren’t Always Intuitive?
Sometimes the source code is written in such a way that only the original developer can really understand the its intent. From personal experience, here’s a number of reasons why:
- The code could be unintuitive or vague
- It could employ a mixture of coding conventions, poor conventions, or no convention
- It may be have no internal documentation, whatsoever
- There may be no information about what the code does or how it should be used, not even one example
The same goes for technology platforms. Now I don’t say this to worry you. If you have a fantastic platform, with outstanding support, you’ve accomplished the majority of the work required.
But don’t let it go to waste by not providing clear (and copious) documentation, so developers can get started quickly, then move on to make the most of it.
Give Me The Child and I’ll Give You The Man
You may be wondering, why the focus on developers. Maybe you’re familiar with a quote, often attributed to Francis Xavier, the founder of the Jesuit Order:
Give me the child until he is seven and I’ll give you the man
There’s a lot in that and it makes a lot of sense when you think about it. If developers become accustomed to working with a specific platform, a specific set of tools, a specific way of working, they’ll want to keep working that way (assuming that it truly allows them to be the best they can be).
As they move to different companies over the course of their career, building new platforms and overhauling existing ones, they’ll want to use the tools and platforms they’re already familiar with.
When questions are asked about what platform or tool is the right one to use given a particular situation, they’ll put forwards the ones they know (and like) best.
If a new platform or tool is sought, because of a new client, to speed up an existing application, to refactor a legacy application, naturally they’ll support the ones they know – if for no other reason than they get to keep working on what they love.
So it makes sense that you need to make yours as easy as possible, by providing thorough documentation, so that yours is the one they choose.
How Do You Do This?
Gladly, the answer is simple and comprised of three simple, yet key parts:
Make a list of all the key technologies & benefits your platform has to offer
Do you provide hosting, caching, email, and logging services. Specifically, what powers those services? Is it Memcached, Postfix, PostgreSQL, Cassandra, MongoDB, MySQL and MariaDB?
With this in mind, are there any peculiarities to accessing these services, which developers should be aware of? How have you made getting up and running simpler, quicker, easier? What key processes or features does your platform provide, which saves time and effort?
Ask yourself what kinds of developers you want to use your platform?
It’d be great to go after every developer on the planet, of which there are hundreds of thousands. But to maximise your platform’s value, as Ramit Sethi says, focus on a specific niche. By doing so, you’ll come to be more acutely aware of the way they think, they needs they have, the supplemental technologies which are important to them, and on the list goes.
Brainstorm a list of potential posts which highlight or demonstrate these services
With these first two steps done, brainstorm a series of posts, which you can add to your blog, which show real, working, usage examples of the various parts of your platform. This can be from the very simple, such as how to roll out framework X, to the more complex, such as how to manage a deployment process.
Over the course of weeks and months, you’ll begin to carve out a place for yourself, with the niche you’ve identified. You’ll begin building a reputation with them as one of their preferred choices; because you understand them so well. I won’t try and tell you that it will come overnight. But given time, focus and dedication, I’m confident you’ll see the results you want.
Granted, it’s one thing to say all this, and another thing to do it. So if you’re keen, but finding it tough going, email me and let’s see what we can do, together, to get it happening for you.
Otherwise, are you already doing this? If so, what’s your return on the investment been like? More than you expected? Less? Somewhere in the middle. Share your experiences in the comments.
Join the Email List
If you enjoyed this post, why not join the email list and get all future posts straight to your inbox? In addition, you'll get background information, extra research, and other content that's only available on the list. I promise I'll NEVER spam you. And you can unsubscribe at any time.