share
Stack OverflowProgrammer, not a blogger
[+106] [32] Someone
[2009-10-13 22:22:27]
[ communication blogs technical-writing ]
[ http://stackoverflow.com/questions/1563280] [DELETED]

I need advice from people who might understand where I'm coming from. I'm the lead engineer on a software product. The company I'm working for recently expressed serious interest in having me blog about it (much to my dread). They even had someone set me up a blog.

I have Asperger's disorder. I'm really good at taking complex software problems and finding wonderfully elegant solutions. I don't know the first thing about writing interesting and engaging text. Writing for me is a difficult problem, one that doesn't have a defined solution.

I'm really struggling with this and it eats into a lot of time I could spend getting things done. I love the company I'm working for, but I'm worried what it'll mean if I tell them I can't do it.

I don't know how to tell my employer that what they are asking for is something that's totally beyond me.

Help or advice anyone?

Update

Thank you everyone! Wow, such great responses, lots of great advice!! It was very hard and took a long time, but I was able to do it. I'm going to stick with it a bit longer in hopes that it gets easier (the first post is probably the hardest, because it sets the tone and such). Thanks for the kind words, all the advice, and even for the kicks in the pants!! =)

(13) +1 for autistic programmers! wired.com/wired/archive/9.12/aspergers_pr.html - Byron Whitlock
(25) Someone set us up a blog!!!! - DVK
(149) You know, the way you've written this question is actually quite well formed and interesting. Give it a try. - Nick Bedford
(17) Progs before blogs, man. - Mark Rushakoff
(25) Dammit, Jim, I'm a doctor, not a blogger. - Jeanne Pindar
(1) You might even enjoy it, and start to get people being interested in what you write. The Problem/Solution style blog suggestion is probably a great way to start as its close-to-home so to speak. - Nick Bedford
(1) You could also think of it as adding comments in your code :)... nice short blurts of information - fudgey
(1) @DVK +1 for launching all zigs; even though the proper dialect should be: Somebody set us up the blog! - Robert Groves
I like to think of writing as a challenge and attack it like a problem. "What should go here? What would sound the best there? I bet if I structure my points like this, it'll convey information more clearly." Think of this as a problem, and solve it! - Stefan Kendall
@DVK You have no chance to survive make your blog. - Konamiman
Writing, like coding, takes practice to become good at irrespective of your initial starting point. I don't think anyone can write a good blog first time out, even if you think you know your target audience. The old adage "You can't please all the people all the time" comes to mind, plus developers are usually interested in the meat of the piece not the fluff around the outside that's there for the 'regular' people ;) - Lazarus
(2) Can you just tell them no, sorry, you don't want to spend your valuable work time trying to think of something to blog just for the sake of it, and that's not in your job description anyway (unless, of course, it is)? A lot of people have difficulty saying polite but firm no to a request from their boss. But you have to draw the line somewhere, and you will get more respect if you do. - Dale Halliwell
(2) I don't want to criticize your self-criticism, but you wrote a coherent and clear description of your problem. Lots of people can't do that much (including a fair number of SO questioners). You may be selling yourself short. - David Thornley
(2) This question would make a good first and last blog posting…. - Ian Ringrose
SO is probably viewed by mostly the same kind of audience that would view the blog. Judging by the response and the upvotes; I wouldn't worry (+: Oh.. and i think i speak for many others when i say i'd like to visit the blog too - Everyone
Clearly, Everyone likes the idea. - Michael Myers
Get involved, and there is no turning back:)) - Teoman Soygul
[+139] [2009-10-13 22:26:17] Greg Hewgill [ACCEPTED]

You might not like this, but don't use asperger's as a crutch. What you've written here is clear and succinct, so you've shown you can write prose. It doesn't have to be good, or even interesting to anybody but yourself, but just spend some minutes a day writing something about something.


(4) +1 - Excellent point. - Otávio Décio
Greg - I agree somewhat but it IS devilishly hard to write for someone who has Aspergers symptoms. I am not a clinical case (I have many symptoms though) - and although I can be a fairly good writer when I want to / have to, it take hell of a lot out of me. - DVK
(2) @DVK: Writing prose takes effort for me too; I certainly appreciate the difficulty. - Greg Hewgill
(4) You should ask your employer if they're looking for a particular kind of style in the blog. If the style of your question is okay with them, I would encourage you to give it a try. For many people, writing gets quicker and easier with practice. - Bob Murphy
So if you're not a clinical case does that mean you're self-diagnosed? - Azeem.Butt
(3) Well, here's the point. He's NOT saying he'd write badly. He's saying it is extremely difficult, causes a lot of anxiety, and takes a whole lot of time. It makes sense that if you torture yourself over a couple paragraphs for a few hours the end product might be good. While I agree that people should always push themselves to do more (including the uncomfortable), they are personally the only ones who can decide what is and is not simply too much. - darron
1
[+53] [2009-10-13 22:27:13] S.Lott

Consider the following:

  1. "I have aspergers disorder" No one cares. Seriously. If you've written any good code, we don't care about your personal life. If we knew you, we probably would care. However, we don't know you -- we only know your writing.

  2. "I don't know the first thing about writing interesting and engaging text". Neither do 85% of the bloggers I read. No one cares. Seriously. if you've written any good code, we don't care if your text is not "interesting or engaging" We value factual and helpful.

  3. "Writing for me is a difficult problem, one that doesn't have a defined solution." You're wrong. It has a defined solution. Simplicity, clarity, accuracy, and a good fit with other people who are simple, clear and accurate. Read Knuth or Dijkstra or Wirth. Copy their style.

Get over it. Share your insights. Help other programmers.


(35) -1 for excessive callousness. - TrueWill
(5) Bit harsh don't you think? - Nick Bedford
#2 made me LOL. so true - Frank Schwieterman
(7) At the end of the blog post, the name is just a name. Not a "person" with a personal life narrative and issues to overcome. Look at all the blogs you read. Seriously. How many of those writers do you know as a person? A writer is their words, not their personal life history. Hiding behind a personal life narrative is a cop-out. I am intentionally harsh because the question is an attempt to hide behind a personal problem. - S.Lott
(35) +1 for telling it like it is - Polaris878
(9) #2 and #3 - 90% of the time if your company wants you to write a blog, they are not doing it to help other programmers. they are doing it hoping that you include a lot of keywords that will enhance their Google positioning in your particular industry. - mmc
@mmc: Don't assume. Ask. This should be part of a communication plan, the result of executing a corporate communcations strategy. - MSalters
I don't agree with #2. If the text is not something I enjoy reading (due to it being interesting and engaging, for example) I'm not going to read it, and it won't add anything of value. Even if you've built some amazingly briljant piece of code, if there is text accompanying it, it should add some value, otherwise, I'll just take the code and learn from that. - Rik
@Rik: The code is the text. You're proving my point. No one needs to obsess over their ability to write interesting and engaging. Just post code with commentary. That's what a good blog is anyway. - S.Lott
(1) Look, the internet doesn't care... and there a name is just a name. However, this is not some nearly anonymous blog TO HIM. His employer wants him to write, and what he writes would certainly affect his employer's and coworkers' impression of him. While your #1 and #2 points are true from the point of view of an average internet user, I think they're quite wrong in the context of his personal associations and relationships. #3 is also IMO wrong. The solution space for "simplicity, clarity, accuracy", etc might as well be infinite. - darron
(1) -1 for being being a part of the problem and not the solution. - cballou
@cballou: "problem"? What problem? The OP has a question about their problem. I can't see how I caused Aspergers, or someone to use Aspergers as a crutch. Please provide some guidance on what the "problem" is and how I'm the cause. - S.Lott
(1) I disagree with #3 quite strongly. One guy's simple is another guy's confusing. Writing is nothing like math, where if you got the right answer you know it and no one's preference or opinion can make the good answer suddenly become bad. That's why writing is an open-ended problem in the eyes of someone on the highly structured end of the neurological spectrum. What you don't seem to acknowledge is the absolute truth that, for some people, no amount of training or willpower can significantly reduce the anxiety associated with the lack of a predictable determination of correctness. - Darryl
After reading dblack's comment, I realize I disagree with #1 and #2 pretty strongly too. His company and co-workers care very much about how his personality and skills affect his ability to meet the goals of the blog he's been asked to write. He's right to consider them. - Darryl
@Darryl: I do acknowledge "no amount of training or willpower can significantly reduce the anxiety". My point is that it doesn't matter. The anxiety is not something to hide behind. Just do it. - S.Lott
@Darryl and @dblack: #1 and #2 are "quite wrong in the context of his personal associations and relationships." I'm not talking about the associations and relationships. I'm talking about writing a blog, which is entirely different. There is no relationship. Thre's no reason to hide behind Aspergers or -- in my daughter's case -- craniosynostosis. One can hide behind your condition or leverage it and help others. Just do it. - S.Lott
(3) +1 Man up nancy - Jack Lloyd
2
[+30] [2009-10-13 22:39:04] Nir Levy

maybe do a "problem:solution" type of blog. present a problem you faced at work (could be very low level "got this compiler warning" or high level "had to design a system for x") and explain how you solved it.

It will be a good reference for yourself, and others may also read it.


You're right!!! This is a really good idea for getting started. - yelinna
That's what I do in my blog: it's primarily a reference work. Some posts are solutions to problems that don't seem to be elsewhere on the net. Other posts are the results of research I've done. There's little in the way of opinions - the net is already too full of opinions, in my opinion. :-) - Bob Murphy
(2) +1 good suggestion to provide structure for a blog, to get over that "blank page" anxiety. - Bill Karwin
(shameless self promotion) that is what i do on /my/ blog as well. I started it when i found out that some problems pop up every year or so and i never really remembered how i solved them last time.. now i have 100 pageviews a day and first link in google for some questions... - Nir Levy
3
[+26] [2009-10-13 23:28:08] Darryl

As a developer with aspergers myself, I know where you're coming from. As others have pointed out, your writing skills seem up to the challenge. What others may not realize is how long a person with aspergers might take to generate that. I sometimes take hours writing a couple of paragraphs, trying to be sure I communicate precisely what I intend to communicate. If that isn't a problem for you, blogging might actually be a great activity for you. Even if you do excessively deliberate on your writing like I tend to, it still might be a good activity, a good chance to do something akin to socializing, but with structured boundaries.

If I were in your shoes I would ask exactly what they want to get out of the blog, then write a couple of sample posts. Track how much time it took, then convert it to dollars. Show the person in charge what you came up with, and how much it cost. If they think the post you show them is worth $300 (or however much) of your time, fine, go for it.


(2) Yes, this is a very simple way to approach the problem. While it may somewhat emphasizes a weakness... which may not be such a great idea... it's probably the most reasonable course of action. If it does take him a very long time to write blog entries (which I strongly suspect), and he does it on company time... that will come out eventually and may be quite bad for him if they think there's no way they would have wanted him to follow through if they knew. - darron
4
[+11] [2009-10-13 22:31:22] OpenSource

Blogging, unlike a book or a column, is for you and not for someone else - if you realise this I think it will reduce your anxiety level a lot.


(6) Not always. Sometimes company-sponsored blogs are a hidden form of corporate marketing communications. You have to find out beforehand whether the company really wants spontaneity and candor, or just different versions of "W00t we're having a great time writing X it's so cool working here we have a pinball machine u need to buy it when we ship." - Bob Murphy
(1) If blogging is part of your job duties (formally or informally), then it is not for yourself. - Dave Sherohman
Yeah. If he doesn't want to write and his company is pressuring him to... how can that be "for him?" - darron
(1) -1: "Blogging... is for you and not for someone else": Are you kidding? - Jim G.
5
[+9] [2009-10-13 22:34:55] Cade Roux

They want you to blog, they are willing to pay you to do it and willing to give you the time to do it? Public or private?

Seems like a good deal to me. Just like writing documentation or whatever. There's always downtime - waiting on builds, waiting on installs, etc., this is when I usually work on little things. If a blog post takes hours of new research/coding/samples, there needs to be commitment by the company that this is valuable.

If, however, there is no extra compensation or reduction in other expected workload or assistance to build test cases/samples, I'd give it a pass - like so many corporate initiatives, it could just be management following a fad, with no actual commitment.


While I agree that they very much should allow him to do either this on company time or pay him for any extra time, ultimately he must consider what refusing to participate will mean to his future there. - darron
6
[+6] [2009-10-13 22:27:29] Amirshk

How about hiring a profesional writer?

You could explain your ideas and thoughts, and she/he will put it on paper.


(1) The difficulty might be getting the company to pay for that service. - Jonathan Leffler
(9) They'll be paying for it one way or another. - Cade Roux
@Cade, I beg to differ. Talk to business about paying $20,000 for a new guy to do it part-time or paying $0 for an employee to- guess what the short-term-minded business folks will pick? - Phil
(1) If the blog is for internal use, then the actual content is probably more important then how it is pronounced. However, these blogs are sometimes used to show customers/investors how skilled the tech team is. In that case hiring a professional writer might mean more income. - Amirshk
(3) I think this is a good suggestion, but instead of hiring a pro, he should write what he wants to say in the bluntest possible terms and give it to the marketing department to edit before he posts it. Blogging is likely a "social media outreach" brainchild of marketing, so they should be supporting him. - Sarah Mei
(3) @Phil Like I said, short-term-minded business folks will be paying for it one way or another. Having a highly compensated programming lead blogging is a massive intangible cost - and a huge opportunity cost. I'm not saying it's a waste, I'm just saying they'll be paying for it. - Cade Roux
7
[+4] [2009-10-13 22:43:00] T.E.D.

I'm not an expert on your condition, but from what I do understand, perhaps you would have better luck with it if you consider it writing for yourself. What advice or documentation (or even experiences) would you like to have seen written before you started your latest misaventure in software development?

I do most of my documentation as a similar exercise.


+1 for using the phrase "latest misadventure in software development". :) - Martha
No matter how you look at it, fulfilling a job responsibility is not writing for yourself. - Dave Sherohman
I'd disagree with that, Dave. I've met plenty of people who do just what they are directed to do, and not one iota more. However, if you sit down and really document things, you are perhaps fufilling a moral responsibility of your job, but you are almost always going past what your bosses would force you to do. Usually, they'd really rather you were spending paid time writing something with curly-brackets in it. - T.E.D.
8
[+4] [2009-10-13 22:59:47] rmeador

I couldn't agree with Nick Bedord more. You've already written a correct, well-formed, easy-to-understand piece about what you're doing at work and posted it on the internet. How is it different whether you're writing about them asking you to blog, or them asking you to code some nifty widget? Maybe it would help you to think that you're writing it to the SO crowd :)


...the point is, it's difficult. This 'piece' could've taken an hour or two to write. I know for myself, it's common for an email to a colleague asking one or two questions can take me over an hour to write. It's not the destination, it's the journey that sucks. - Mead
I can't speak for the OP, but I've been a member of SO for over a year and posted a grand total of three questions. There's a substantial difference between posting here once every 3-4 months and being responsible for finding topics to write about on a daily or weekly basis for a blog. - Dave Sherohman
9
[+4] [2009-10-14 07:34:33] MAK

Writing a technical blog does not mean that the content has to be in the same style as any popular non-tech blog on the internet. Focusing on the content rather than worrying too much about the style, at least at the start, might be a good idea.

It does not have to be funny or witty, as long as you are clearly explaining the topic. Not everyone will agree with me on this, but often I find a wikipedia article or a blog written in the same style more useful than a blog explaining the same things and trying to be funny at the same time (even if it does succeed in being funny).


10
[+3] [2009-10-14 02:33:02] Mike Kale

It seems that you can do it, judging by this post. The question then is: 1) how long does it take you (and how much does it take out of you) to write X amount of prose, and 2) how much code could you have written in that time / effort. If you can quantify both of those things, you can go to your employer and ask them to make the tradeoff. (I hope they're not asking you to blog in your spare time, or in addition to everything else you were doing before!)

If they know the tradeoff and still choose blogging, then you have to decide if it's what you want or not -- it might open new doors for you and expose you to new things, but it also might just annoy you and leave you worn out at the end of the day/week. At that point, it's up to you to decide if you want to stay at the job or not.

Another approach, if they really want you to do it but you don't: you could just do it badly until they relent. Presumably they've hired you to be a programmer first and everything else second, and would rather keep the good programmer than lose you to another job over this.

My two cents.


11
[+3] [2009-10-13 23:15:36] Avi

I sympathize with your plight. Obviously, blogging is not your vocation. Even if you could do it, this is not what you WANT to do, and you shouldn't be forced to do it! I understand the "suits" PR need for a blog, "keeping in touch with our customers", "opening windows into our company". But, hey, some of us just want to code! Next they would ask you to do community service to improve the company's image.

So what I would do is follow Mr. Ferriss's suggestion and outsource this work to someone in India, and pay for it out of my own pocket.

The 4 Hour Workweek [1]

[1] http://www.fourhourworkweek.com/

12
[+2] [2009-10-13 22:45:49] JW

One of the most important tasks we face as programmers is communicating our ideas to other people. It's arguably just as important as communicating our ideas to machines. Most projects are done in collaboration with other developers, managers, and designers. And they need to be documented well enough that future developers can maintain them.

So your job is to explain your work in such a way that anyone can understand it. In this case your audience is wider than you're used to, but it's basically the same task. Take a complex technical concept and reduce it to its essentials. Get out of your head a little, and try to look at it from other people's perspective.

Of course, it's difficult for people who don't have Aspergers (I don't) to understand exactly how it affects your ability to communicate. You might want to expand on that in your question. But in any case, it seems like a worthwhile effort to make.

Or -- how about explicitly writing from the perspective of someone with Aspergers? Not sure if your company would go for that, but it could be interesting.


13
[+2] [2009-10-13 22:35:31] Phil

Be honest and tell them that you cannot do it and why. HOWEVER, you are willing to give tips to someone that will do it (assuming you are). It is as simple as that. You can also suggest that they have someone more business-oriented (aka someone working in the business) to do it and use you as a technical reference to increase the blog's relevance.


14
[+2] [2009-10-14 07:51:05] Lars D

Aspergers is not the problem, because your audience might also include a number of aspergers people... the problem is, who is your audience, and what is the purpose of the blog?

Many of the most popular blogs are provocative. They come up with very simple statements that are obviously incorrect, but generate a lot of debate. You should ask your boss about the purpose of the blog, and the intended target audience. If the boss asks back, you can inform your boss that making your customers angry is the shortest path to a large audience...

Another solution can be, that you define the target audience that you communicate well to. If your boss wants to attract attention of nerds, an easy way to do that is to tell about company internal stuff, like how did you solve problem XYZ etc. Ask your boss, how you can easily determine, which of your company internal information, that you can reveal to the outside. Unfortunately, again, the most popular stuff will probably be "how your company failed in helping customers" and stuff like that.

If your Boss says: You are so smart, you must know stuff that others want to read, the answer is simple: "Thanks, but if you want a blog about that kind of stuff, then I need 1-2 days off per week, and I will need a couple of months of practice before I get started." Added value usually comes at a cost, and you need to tell your boss, what the costs are.

All these suggestions share one thing: Your boss is probably not willing to pay the costs that make you able to write a good blog well. Use that in your advantage.


15
[+2] [2009-10-14 08:46:15] IanW

If they have asked you them I'm guessing someone in the companies management has seen what you have written in the past (code documentation ?) and liked it so they must think you are up to the job.

In my experience its best not to outright refuse to do something like this or bring up some kind of medical reason why you can't do it as you will come across as being negative. Try saying you will do it but that you have read there are many pitfalls in corporate blogging and/or don't want to accidentally give away any trade secrets. So ask if someone in the senior management of the company could check your posts before they go "live" it may also be worth asking if you can write the blog for a few weeks before the blog is made public. This way both you and the management get to see if you can do this job with no risk of embarrassment to you or the company.

I do agree with previous posters in that your question was so well written I suspect you may be underestimating your own abilities in this field.

Oh and if you can't think of anything to write about just look at other company blogs for posting ideas.

Good Luck.

Ian


16
[+2] [2009-10-14 09:17:46] Galwegian

You know it's often the case that the most worthwhile things you've done in your life are the things that have been outside your comfort zone.

There can be no success without challenge.


17
[+2] [2009-10-14 12:19:44] modernzombie

You know what, a couple of years ago I would have said that I couldn't write. I did horribly in English/Grammer/Writing in high school.

When I first started blogging it wasn't because someone asked me too, it was just a way for me to write down solutions to problems I'd run into or my thoughts on various programming topics. My intention was just to have a place to store this information in case I needed it again.

To my surprise it didn't take long before I was really enjoying it and other people were liking it and reading it also. Two years later and I am doing some freelance writing at night after my programming day job because I like it so much.

It can't hurt to give it a try. You never know you may be pleasantly surprised.


18
[+2] [2009-10-14 12:33:41] cetnar

Try ask questions and answers to others questions in SO (just as you did it). If you'll be good at - writing a blog will be no problem for you.

Tip. Blog entries doesn't need to be long, they should be usefull.


19
[+1] [2009-10-14 12:41:04] mallows98

You have stated that your company wants you to create and update blogs on their behalf. I've got some questions to raise:

  • What was the driving force that lead your company to appoint you to create a blog? Is it for marketing/ company visibility reasons, educational reasons, etc.?
  • By setting this blog, would this task of creating blog entries help the company and your clients to boost productivity for your products/services?
  • Should you agree to accept the task of creating blog entries, would there be a process in place, i.e. would your company moderate the items that would be published?

When setting blogs, you have to remember that anything that you will write in your blog will not just reflect your work, but your company as a whole regardless if it is popular or not.

Also keep in mind that the blog that you will be publishing (should you agree to take up the task) will NOT be judged on what your personal background is but for the content that you will produce, which in turn reflect your company's views as well.

Another thing that I would like to raise is that I detect a hint of uncertainty on your part because:

  1. You are entering into an unknown territory where you are tasked to document about something that involves your work and make sure that anything that you document should be "engaging and interesting".
  2. You are also concerned that doing a blog would be an additional workload for you and might affect your other workload as well.

If you are worried about not knowing how to write "engaging and interesting test", I encourage you not to worry because all bloggers started out with boring blogs anyway (even I myself started like this as well). Think of this as a challenge and an opportunity to learn and improve more on how to communicate via text-- I can assure you that at the end of the day, it will be an additional skill asset that will be empowering for you in all aspects of your life. Looking at what you have wrote here is very good and clear, and I encourage you to use it as a starting point for your writing.

On the other hand, if you still have some issues and not comfortable about this, I strongly suggest that you should talk to your superiors and be honest about your concerns. At least both you and your company would know what would be the next action to take if they are really pushing for this blog to happen.

Hope this helps!


20
[+1] [2009-10-13 23:19:55] sean riley

Read Elements of Style [1]!

This book was written a long time ago, but it explains how to write prose in a way that could have been custom made for programmers. The similarities between writing and programming are larger than you might think.

Also, I agree with S.Lott.. most bloggers have no idea how to write.

[1] http://en.wikipedia.org/wiki/The%5FElements%5Fof%5FStyle

21
[+1] [2009-10-13 23:22:27] baeltazor

Judging by your question, you're a very good writer. Is it that you don't want to write on a blog, or more that you feel you don't have anything to say?

I honestly don't believe that you'd have any problems writing a blog... I'd read it! The way you wrote your question made me read it right to the end, even though I never usually read questions like these. +1


22
[+1] [2009-10-13 22:44:35] Gordon Mackie JoanMiro

Presumably they are impressed by the quality of your programming and the coding solutions you provide them with.

So I would say: publish your actual code or samples - if you can - and say what you can about it in explanation. Don't worry about the structure, the grammar or the professionalism of the blogging itself.

If you aren't a natural educator, then you just aren't; whatever the reason. But if you can bring out some of your thinking in the production of your code, then at least you are broadening access to it and the thought processes, analysis and design, that led to it.


23
[+1] [2009-10-13 22:38:49] Larry Lustig

The essence of programming and the essence of technical writing (all writing, for that matter) are the same — the clear expression of ideas. Treat your blog entries like a programming task for which you're seeking the clearest expression and you should be fine.


24
[+1] [2009-10-13 23:31:27] Tim

Make this your first post. Initially you can have someone post the content if you write it.

Blog what you are interested in and about the problems you are solving. Don;t let it consume you or intimidate you.

Just be yourself and you may or may not have an audience.

Make sure you keep coding well.


25
[+1] [2009-10-14 02:25:10] mcxiand

just do it!!! :)


26
[+1] [2009-10-14 02:31:03] George

check out

http://blog.penelopetrunk.com/

The author has aspergers also and she's a great blogger. Read the blog thoroughly


27
[0] [2009-10-13 23:17:44] conejoroy

is it a must to write interesting and engaging things? interesting and engaging to who? I see a lot of people opening blogs and trying to be interesting and engaging to others, to the rest, a lot of times forcing their natural behaviour in the interest to sound "cool".. well, it is really an effort, hours spent trying to be fun to others... but a blog is not just for that.

i'd really love to read about how you elegantly solved a complex problem; what were the other not so elegant solutions. that is interesting.

just write about what you do. interesting is what you do, no how you write it. just write about what you do and don't waste time forcing it to sound "engaging", I personally don't care.

good luck =)!


28
[0] [2009-10-13 22:37:17] JB King

Have you thought about asking what you are supposed to put into the blog? There are a couple different routes you could take to my mind:

  • Features of product - Why should someone want to use the product? What cool new features are you putting into it? Alexey Rusakov on Sitecore development [1] could work as an example with Sitecore as his employer.

  • Development of software - In a way this may be more personal but is more interesting to other developers, IMO. Here you'd discuss what method and tools you use and what cool things you did with them in building the product.

Each could have their appeal and maybe the company wants you to pick which way you want to go. The first category does have the cavaet of being labelled as propaganda if the company's marketing department has too much control over it.

[1] http://www.alexeyrusakov.com/sitecoreblog/

29
[0] [2009-10-13 22:33:12] Matthew Scharley

If you have a valid reason for not wanting to do the blog, and in my estimation Aspergers would probably count, then I think you should explain your situation to whoevers in charge. If you're working somewhere reasonable, then it shouldn't be a large problem.

Other than this, I do agree with Greg. As someone who's written fiction, the biggest problem with writing is actually writing. Write something, even if it's incomprehensible garbage. As long as the ideas are all there, you or anyone else can clean it up. Most programming blogs aren't written in an 'interesting' manner, it's the facts and details themselves which are engaging to your target audience. As long as it's written clearly, the interest will come. From the way your question is written, writing clearly doesn't seem to be an issue for you. So write. Get stuff on paper. Give it a few weeks. If it still isn't working out, then talk to someone. But give it a try first. You may even find you like doing it by the end.


30
[0] [2011-04-01 15:55:12] imz

As for me (I hardly know anything about your condition, so I'm just sharing my experience with writing texts), I have noticed that writing a certain text (a blog post, a presentation of some code or scientific idea, or whatever) is becoming an ever more intimidating and unclear and anxious-making task for me the more I try to finish the text sitting alone in front of a computer or a piece of paper. I hoped that it's a matter of experience, but it doen't seem to become better the more texts I write.

Becoming more free in the physical space (e.g., taking a walk) makes me a bit more free and clear in my mind, so that I can better and clearer express what I intended to express. The freedom feeling eases a bit the anxiety.

But the most helpful thing is commnicating with someone. If I go and try first tell something in a very free informal manner to someone, then writing it down immediately after I successully communicated the idea to someone can be perhaps 1000 times easier and faster than writing it down just sitting in front of the computer without actual lively communication with people on this topic. Just don't let the encouragement the insteresting communication has given you go away, don't distract yourself to other topics, write down the essential thing.

As for me, I also say to myself and it helps: Don't try to write something complete and perfect in all the aspects of your intended text. First, express the main idea the way you would tell it to someone, and don't be anxious about the imperfectnesses. Then, calm down, look at it once again, re-read it, and go on extending it: add some missing references, notes, some side ideas. Then, perhaps, you might want to expand on some of those "side" ideas. Then look at the text as a whole once again, calmly. Give yourself freedom to imagine how the text could become better (I can't really conciously control my creative activity in thinking and imagining, so it's better not to try to direct oneslf, not even to have a strcit plan or think about a plan, but just feel free and not anxious); perhaps, restructure it, beautify, add illustrations, think of some concept that would go through your text and help organize the presentation so that the text will be more clear and concise to the readers, without involving any distracting, not really relevant notions.

The wiki way of doing small edits step-by-step, ever improving the text helps me a lot. I'm not anxious anymore about it being imperfect: I can return and edit it and extend later. It's much more important that it can be useful to the readers right away, rather than that it is not perfect yet. This idea helps me calm down and lower my anxiety.

I find it unfortunate that one often has to prepare something written down to present one's ideas at scientific seminars, because it's so hard for me to write something clear when I'm alone, and so much easier to write something down after you already have discussed it (at a seminar). It becomes a circular problem: to write something down, I have to discuss it before; to discuss it, I'm supposed to write something down--the thing I'll present at a seminar.

Good luck!


31
[0] [2009-10-14 09:51:49] GeM

Congratulations first and foremost - even though this is a daunting task it's not one they would have given you if they didn't think you were capable of it. Not an opportunity that comes to many technical people who do enjoy writing!

As a secondary option to reading 'The Elements of Style' (great book) I'd pick a blog that you enjoy, try and articulate five reasons that you enjoy it more than any other and try and apply these to your own work.

May also be worth discussing with the business the amount of time they expect you to spend on the blog each week (or the expected 'blog' output) where you would have an opportunity to mention Asperger's as part of a more 'practical' discussion.

Best wishes.


32