Are you stuck with a stupid boss or a boss that makes stupid decisions? Maybe I can help.

In Israel, where there seems to still be a tremendous lack of professional management experience, technical writers are often managed by self-made managers or R&D people with no formal management experience and little or no experience managing technical writers or technical writing teams. What that means is that they might know how to program in X or Y language, or run an Agile process, but they know next to nothing about managing people and even less about how to control their own tempers. There’s no excuse for managers who blow their top and take out their misguided anger on undeserving employees.  But unfortunately, it happens all too often.  Let me give you some...

34

Yesterday started out like any other Monday, or at least I thought it did. I had a few urgent emails from technical writers and customers, a sick daughter, and another kid who requested a gourmet packed lunch that included macadamia nuts, and to wear purple shoes which we don’t have…you know, a typical Monday morning. And of course, Sunday night I was up until way past midnight closing a contract with a new customer (start-up nation Israel never sleeps).

But at about 9:30, everything suddenly fell apart. Our weekly staff meeting was interrupted by my sick daughter asking a million questions ranging from how we could be talking into the...

296

2011 was a year of change. At least that's what LinkedIn announced to me, informing me that 204 of my colleagues had changed jobs.

204? That sounded like a lot of people changing jobs. Then I looked up my contact list, did a bit of simple math, and figured out it was just over 21%. Now it looks low, because I can't think of anyone I know who's been in a job for more than 5 years. In my industry, a normal number might be 30%. OK, I know a few teachers. I...

203

Much has been said already about how great it is to work “in the cloud.” I don’t think there’s anyone left who hasn’t experienced the greatness of Dropbox or a shared Google Doc.

So where does that leave the technical writer? We technical writers and documentation managers are long used to our love affair and possessive tendencies towards our “files” and our proprietary authoring software. A huge part of what gave us value was the relative obscurity of what we do. Transforming huge swaths of knowledge and information into books, with endless links and ToCs that update and indexes that contain links. One customer even went so far as to call what we do, “knowledge geek magic....

326

Companies spend so much time, money and effort trying to understand and quantify what their users are saying and thinking about their products. In software development, UI design receives hyperfocus and in hardware or devices, testing and usability receive a good portion of time and budget (not to mention focus) during the development stage.

Much to my dismay, documentation is still perceived as a separate entity from the product. R&D budgets for the project rarely include documentation. Instead, it gets tacked on at the end as an afterthought, a necessary evil. I keep rallying against this because I continue to believe that this is a critical product,...

898

We'd planned to get back to business in today's post, but the response from yesterday's post was so overwhelming that our server even crashed for a few minutes. In light of the huge response and the huge outpouring of support last night at the Beit Shemesh rally, we felt we should briefly follow up.

Firstly, we want to say thank you. Thank you for your readership, for your responses here and in the social media. Thank you for re-posting and spreading the word. Thank you for coming to the rally, for voicing your own opinions and experiences, and thank you for your ongoing commitment to a...

268

There comes a time when even in a professional blog like this, it is our responsibility to take a stand on public issues.

Our country's headlines over the last few weeks have been filled with stories of ultra-Orthodox men speaking harshly and striking out against women who, in their eyes, are dressed or acting in ways they feel are not in keeping with Judaism. We see stories of women being relegated to the back of the bus, of advertising posters being censored or self-censored by organizations who do not want to offend this minority.

As a company run by an Orthodox female CEO, we feel it is important for us to state our opinion in no uncertain terms. As a company with many orthodox and ultra-Orthodox employees, we have until now steered clear of speaking about...

1,884

Search