Author-it Software Corporation is the world's leading provider of component content management software. Over 3500 clients in 50 countries are content in the knowledge that they have chosen the most reliable and proven system for authoring, content management, language translation management and single-source publishing to multiple outputs.
The Author-it Blog

FRIDAY, 13 MAY, 2011

Annual STC Conference

It’s that magical time of the year, when STC holds its international conference. This year the conference is in Sacramento, California, a short drive from the lovely city of San Francisco. A slightly longer drive from Southern California, where I live, but I’m driving up, nonetheless. I have family there and I’m spending a little time with them before I come home.

If you are at the STC conference and want to talk, stop by the booth. We will be doing in-booth demonstrations during the breaks, so if you want to see some new stuff, this is your chance. If you want to talk about what Author-it can do for you, several of us will be there to do just that. Paul Trotter and Steve Davis will also be there to talk about what we’re doing and what’s coming.

Do you want to win an iPad?

This year, we’re giving away an iPad. You know you want one – I certainly do. To get in the drawing for the iPad, we’re doing something special. Late morning Monday, we’re giving out special, limited edition, Author-it shirts in the Author-it booth. You want one of these.

We only have 150 of these shirts, many fewer than conference attendees. To be eligible for the iPad, you need the special shirt. Then you wear the shirt during the conference. At some point, we’ll select a person wearing the shirt and give them the iPad. You don’t know when we’ll do that, so it’s important to always have your shirt on.

Other prizes

If you miss the shirt, we have other prizes we’re giving away, including a free copy of each of the new Author-it books. You could win Author-it Success in 12 Easy steps by John Hedtke, or Learning Author-it by Char James-Tanny. We’re very excited about these books and think you will be too.

Blogging from the conference

I’m hoping – internet connection willing – to be blogging from the conference. We’re certainly tweeting and posting to FaceBook and Tumblr. Watch our social media for what’s happening at the booth, who is winning prizes, and more.

Good luck on the iPad!

by Sharon Burton

TUESDAY, 10 MAY, 2011

Content Development Best Practices

I was away last week at a client site, working with them on how to move to Author-it. They bought Author-it because they see the benefits, but, like a lot of companies who are looking to improve their workflow, they didn’t really know where to start. What would be Best Practices for them? How to get there fast so as to not interrupt the current deadlines?

They also wanted to use this move to better architect their content so they got more value out of what they have.

And so we started

We started with looking at the content they had and how they currently use it. They sell large industrial machines that are sold either 1) “as built” with no customizations, or 2) somewhat to extremely customized. They don’t do online help, so we just looked at producing PDFs. Of course, if they need to someday move to help, that’s super easy for them.

They had been doing docs in InDesign and Ventura and had to copy, save, edit, and rebuild every time a customer wanted a manual 2 type. This process took 1 to 3 days, not counting any new content development or any review time.

What they wanted to know was how to go about this process in Author-it. We walked through how to build a book and  then use variants to create the custom books. They got very excited that the 3 days of production would be reduced to less than a day.

Importing existing content

Then we started importing content from Ventura and InDesign to see what that was going to involve. It’s one thing to get new tools to improve your workflow, but if getting the content into the new tool is hard or impossible, that’s something else entirely.

The good news is that getting the content in from Ventura turned out to be super easy – we had the profile set up in under an hour. This is in large part because the docs staff had stuck to a short list of paragraph formats and didn’t play fast and loose. One of the advantages to a team that has been in place for many years is this sort of rigorous adherence to the templates.

The InDesign docs, however, are a different story. People in and outside the docs group created the InDesign docs. The adherence to the template was, well, less strict. We got the basic profile created pretty quickly, but there is going to be some pre-import work needed to put all the text in InDesign into one flow, instead of the adhoc flows it is in now, for example.

Changes to the workflow

Then we started looking at the workflow issues they needed to change to make this all work. The specific details for them are not important to us here, but the big picture is.

They needed to review how they:

  • Import existing content – release states to know what’s been roughly imported, reviewed after import, ready to start publishing, and so on
  • Develop content – what is truly new content and what should be reused, where to put content, how to know it’s ready for reviews
  • Manage existing content – version, variants, release states, and so on
  • Structure and locations of graphics folders- where to put overall graphics, product line graphics, one-off graphics, and so on
  • Reuse content – what can be reused vs what is currently being reused, where to put reused content, how to name it, and so on
  • Review content – how do they send out just the content that actually needs to be reviewed vs all the content in a manual, and more
  • Manage localized content – they don’t do a lot but when they need to they need to right now
  • Archive content and understand the history – what topics shipped in what manuals when? When was that topic changed and to what?

In sum

Even if you’re not thinking about moving to Author-it, these are all issues you must face when you move from one tool to another. You certainly can just start dumping your existing content into the new tool, but I think that many of the problems you had with the old tool are still going to be problems in the new one.

It takes planning and work to get the benefits of moving to a tool better suited to the problems you’re trying to solve.

I applaud this client for thinking this through and planning the change. It shows real maturity and that the CEO understands the value of their content.

I was really excited to work with this group and know they will be successful.

A visual

I’m including a photo I took the one warm-ish day I was there. My hotel was right on the Spokane River. One day was sunny and I took a long walk along the river to clear my head after a full day of intensive work. It was great. Being a So Cal girl, I don’t see many rivers. Ones with water, anyway.

(The client was not Kaiser Aluminum, I just liked the lovely river area with the Kaiser plant above the river.)

by Sharon Burton

TUESDAY, 03 MAY, 2011

Author-it is hiring!

Are you driven to see your clients succeed?

We are seeking a smart, hardworking, talented and passionate project implementation professionals to join our Global Services team.

You are experienced in implementing and configuring content management systems (CMS).You remain focused during implementation projects and handle client requests with professionalism. You are confident when delivering product training to technical communication professionals. You are comfortable when advising clients in knowledge transfer workshops about Best Practices.

You are success-driven and work efficiently with others including Project Managers, Business Analysts, Developers and Support Analysts. You maintain confidence when approaching deadlines, including times when problems have been identified.

You have a history of gathering and understanding your client’s requirements and then using this information to deliver successful implementation/training projects. You’re not afraid of challenges, you are self-motivated and you go the extra mile for your clients. You gain satisfaction from pulling together a demanding project and seeing it through to a successful conclusion.

If this sounds like you, contact us now!

We need people ready to make a difference, so start today by sending us your CV along with a covering brief telling us how you can contribute to our team.

We offer

Author-it Software Corporation is on a mission and you can be a part of this by helping our clients succeed in implementing and using Author-it.

If successful, you will become an integral team member of the world leader in software for authoring, content management, multi-output publishing, and localization. Our client list reads like a who’s who of the global market and includes companies such as Microsoft, Philips, XEROX, Oracle, and HP.

We offer outstanding working conditions, a competitive salary and flexible working hours. This role will involve domestic and international travel.

We will train you on Author-it plus our implementation and project management methodologies. Most of the training will be on-the-job, directly working on “real” projects for our clients. A mentor will guide and support you over the first few months while you come up to speed.

Consultant Global services – Head Office, Albany, Auckland, NZ

Role Requirements

A full position description is available on request.

Soft Skills

  • Comfortable in a fast-paced work and cross-functional team environment.
  • Work smart attitude.
  • Follow directions and established project methodologies as well as display talent for new ideas and continuous improvement.
  • Multi-task and prioritise, organized, accurate and detail orientated.
  • Dedicated to making a difference.
  • Excellent verbal and written English communication skills.
  • Self driven with exceptional time and task management ability.
  • Dedicated to making a difference.

Experience and Knowledge

  • A qualification in a technical field.
  • 3+ years practical experience in providing professional services.
  • 1+ years practical experience in using Author-it products preferred.
  • Knowledge of the content management industry is preferred including familiarity with documentation processes from authoring to managing and publishing content.
  • Proven record of delivering client service meeting or exceeding expectations.
  • Ability to understand and communicate using “technical” language.
  • Competence in delivery of training (remote via web-meeting and onsite).
  • Competence in writing technical publications preferred, e.g. user manuals, help systems, or knowledgebases.
  • Competence in Microsoft Word (2007, 2010 including word macros), web technologies (e.g. HTML, XHTML, CSS, XML).
  • Competence in windows environment (e.g. AD groups, server environments, VM).
  • Prior stable work experience.
  • Authorization to work in New Zealand.

Preferable

  • 1+ years’ experience using Author-it.
  • Knowledge of the content management or technical publications industry.
  • Familiarity with the documentation processes from authoring to managing and publishing.
  • Authoring background with other technical communication products.
  • Competence in Help systems (e.g., HLP, CHM, Web Help, Java Help).
  • Knowledge about industry standards (e.g. SCORM, DITA, S1000D).

Client Care Consultant (US-based)

Role Requirements

A full Position Description is available on request.

Soft Skills

  • Comfortable in a fast-paced work and cross-functional team environment.
  • Work smart attitude.
  • Follow directions and established process guidelines as well as display talent for new ideas and continuous improvement.
  • Able to multi-task and prioritise, you are organized, accurate and detail orientated.
  • Excellent verbal and written English communication skills.
  • Self driven with exceptional time and task management ability.
  • Must have the attitude of “How can I make things better” and “EXTREMELY satisfying Client service”.
  • Ability to build and maintain good relationships with clients.
  • Dedicated to making a difference.

Experience and Knowledge

  • A tertiary qualification preferably in a technical field.
  • 3+ years practical experience in delivering professional services and/or client support in the software industry.
  • Proven record of delivering client service meeting or exceeding client expectations.
  • Ability to understand and communicate using “technical” language.
  • Expert in assisting clients on the phone.
  • Ability to analyze requirements and find client focused solutions.
  • Professional in complaint management, effective escalation management.
  • Competence in all Microsoft products (Word, Office, Power Point), web technologies (e.g. HTML, XHTML, CSS, XML).
  • Competence in windows environment (e.g. AD groups, server environments).
  • Prior stable work experience.
  • Available to work 40 hours per week and work a shift arrangement to accommodate all US time zones.
  • Authorization to work in the United States.

Preferable

  • 1+ years’ experience using Author-it.
  • Knowledge of the content management or technical publications industry.
  • Familiarity with the documentation processes from authoring to managing and publishing.
  • Authoring background with other technical communication products.
  • Competence in Help systems (e.g., HLP, CHM, Web Help, Java Help).
  • Knowledge about industry standards (e.g. SCORM, DITA, S1000D).

To apply

We work hard, but enjoy our work and there are some great perks to being part of the Author-it team! Join our global team with members in Europe, Middle East, Asia, Australasia and the US – take your first step today!

To apply, email: ralf.wittgen@author-it.com.

No 9-5vers please; we need consultants who are fully committed and want to make a difference!

No recruiters please!

SATURDAY, 30 APRIL, 2011

Good news all the way

This is a short post, as I’m getting ready to visit with a client next week and need to wrap up projects before I do that. It’s been a rather frantic week.

But if you’re in Spokane, Washington and want to have evening drinks, send contact me and we’ll make a date.

Good news 1

Two new books are coming out about Author-it! I have specific information about the first book now and will share more about the second book in a week or two.

Learning Author-it by Char James-Tanny from XML Press is available this month. Char is a long time user of Author-it, Author-it consultant, and an all around smart person so this book should be very helpful as a reference to learning and using Author-it. I’ve not seen a copy yet, but we’re all very excited about this book.

Good news 2

This week, Paul Trotter gave a free webinar about his vision of the future of content development. We had nearly 300 people sign up, despite the day being Easter Monday holiday for much of the world. We knew the day might not be the best, but with Paul’s travel schedule, it was the only day we could get his attention for an hour.

If you missed this interesting webinar, click here to view the recording.

Lastly

I really hope to see you at the STC Summit in 2 weeks or so. We’ll have New Zealand chocolate fish to give out Monday and Tuesday, as well as interesting and informative activities in the booth.

Don’t forget the special Facebook giveaway – go to our Facebook page (Author-it) and “Like” the page to be entered into a special drawing. We have something very Kiwi to give away to the winner. You don’t have to be at the STC Summit to win.

by Sharon Burton

THURSDAY, 14 APRIL, 2011

Upcoming events and sightings

There’s a lot going on at Author-it in the near future. We have webinars and are attending conferences. These events provide you an opportunity to learn, ask questions, and meet people.

Product webinars

We have several webinars coming up, some product-specific and some tools-independant.

If you’d like to see what’s coming in Author-it 5.5, we have several webinars available for you over the next several weeks. We also have a webinar in May about importing your legacy content into Author-it.

To sign up for any of these webinars, click here. Remember, we record these webinars and make them available the day after so if the scheduled date or time don’t work for you, sign up anyway and you’ll automatically get a link to the recording the next day.

General webinars

We’re also hosting several tools-independant webinars. If you want to learn more about Component Content Management, we’re offering a webinar on that topic April 28th, 1pm Pacific, 4pm Eastern.

Paul Trotter is sharing his vision for content development April 25 at 1pm Pacific, 4pm Eastern. This is also a good webinar if you’re boss doesn’t quite understand what content development is about and why it’s important in this century.

And May 11 at 1pm Pac, 4pm Eastern, we have the Content Trends Survey Results webinar where we look at the data from the survey and what it means to content development professionals.

To sign up for these webinars, click here. We also record these, so again, sign up even if the time and date don’t work for you to automatically get the recording the next day.

Conferences

Author-it is attending the STC Summit May15-18 in Sacramento CA. We’ll have a booth and several of our staff will be there (including me), ready to meet you and talk about how our products can help your organization. Additionally, Kirsty Taylor is presenting tips and tricks in Author-it Localization Manager at the Summit. This is a good way to see how a real user works in Localization Manager.

If you’re not at the STC Summit in Sacramento, then maybe you’ll be at the STC India Summit May 7-8 in Bangalore, India. This exciting event includes Saurabh Kudesia talking about Planning, Managing and Implementing Content Variations using Author-it.

We’ll see you soon!

by Sharon Burton

FRIDAY, 08 APRIL, 2011

Good tools can’t solve a broken process

I was talking to a friend whose employer has merged with another company. My friend’s company spent the last 5 years clawing its way to supportable and repeatable processes throughout the company as they build software products. If you are familiar with the 5 levels of the Capability Maturity Model, they had finally reached something close to a level 4.

It was hard and they struggled but development, testing, and documentation had stable processes that supported consistently developing products.

Then the merger happened.

Post merger

As they bring the 2 companies together, they are also breaking the company into 2 parts, based on markets. The split is not based on previous company affiliation, but rather on the needs of each vertical market both companies sell into. It makes sense to break it up this way, because the products are related but the needs of each vertical are very different.

This could all be very good, except for one thing: the company they merged with has no actual product development processes.

And that could all work if Company A (my friend’s employer) consumed Company B. But that’s not what’s happening. As they break the companies apart and regroup into 2 separate business units, the processes of each company are staying in place. Those people who are moving into the business unit that was Company A get the existing and stable processes of Company A. Those who are moving into the business unit of what was Company B get all the processes of Company B, which is to say, none.

6 levels of the CMM

My friend and I have thought for years there are actually 6 levels of the CMM. We both discovered this level when we ran our own consulting companies. We also learned to identify and then run away when we first met with these potential clients because nothing good ever happened.

The 6th level is negative 1. Working with a negative 1 level will destroy your processes if you are a contracting company providing outsourcing services, like product documentation. Think of it as entropy.

There is a place for the negative 1 level – three people creating some wild new technology in a garage somewhere can actually benefit from this level because it strongly encourages crazy mad ideas that then get tried. These ideas would be shot down any other place because they are crazy mad ideas. But for these people in that garage, it’s a creative environment that works.

The moment these people move into any level of developing the crazy mad ideas into some actual products, level negative 1 will kill them. Perhaps slowly, perhaps quickly, but entropy will have it’s due.

And how do tools fit in here?

Very often, companies with few to no processes decide the problems they’re having are because they don’t have the right tools. If they got the right tools, they reason, this would all be better.

So they build a feature list.

And they buy new tools.

They don’t bother to train anyone, or set up any Best Practices for using the tools. They just buy them, install them, and then continue on the way they’ve been. And nothing changes, except some vendor somewhere got a nice fat check.

New tools are not feature lists

If you (or your company) are thinking about improving how you do the business of what you do, new tools can help a lot. But new tools also require that you look at your existing processes and be brave enough to change what isn’t working. And something isn’t working if you’re looking to get new tools.

Think of purchasing new tools as a time of reflection for your company. Identify what’s not working in your processes and then find tools that support your efforts to make it work better.

Don’t look for new tools based on a feature list – look for new tools based on the business problems you have and the business solutions you need. When you identify the business issues you need to solve, you’re going to be looking at processes as well. You can’t help it.

by Sharon Burton

TUESDAY, 05 APRIL, 2011

Content is a business asset and other thoughts

For most companies, the content they create is critical to the running of the business. Consider for a moment:

  • Policies and procedures – state how the business is to be run, who does what and how. In industries with oversight, such as finance or medical, the business also must show auditors how the company has been running since the last audit. Failure to show this content can result in heavy fines or other bad things.
  • Internal product documents – describe how products should work, the thought processes, the solutions, and so on for developing the products sold. Without these documents, a business has no idea how it builds what it builds. It also don’t know why decisions were made to do X rather than Y.
  • External product documents – explain how to use the products to the people who purchase the products. If the external documents are not helpful, the business (at best) incurs an unreasonable support cost or (at worst) has a high return rate. Both impact available capital in the business. If the business functions in a regulated industry, it must keep the history of the external documents to show potential auditors how the product was described to work or potentially face large fines.
  • Customer support documents – help internal support teams and external customers find a solution to their problems. For expensive internal support teams, quickly finding and understanding how to help a customer gets the customer off the phone and able to move forward. External customers who find a solution on the support site and never call is the ideal, as it costs the company less than pennies per customer.
  • Training materials – few staff arrive knowing how the company works, what safety information they need to know, or how the products work. Training is how a company shares it’s tribal knowledge with the new tribe members. Many companies save a great deal of money on their insurance by making sure all new employees are trained in the required safety protocols. If the business needs to train customers on how the products work, the training center is a profit center.
  • Marketing collateral – positions the products to the appropriate sales market. Few companies have a product so needed that no advertising is needed to sell the product. Failure to attract customers to the products negatively impacts the business.

Content as a business asset

The groupings above just touch on the broad types of content a business needs to manage. Even a small mom-and-pop store has some of the types of content listed above. For large international companies, the sheer amount of content assets, just as with hardware assets, for example, can be overwhelming.

Best of Breed companies know their business content is an asset that needs to be managed, just like the other assets in the company. Most companies track the computers and cell phones they use, for example. Annually, all the equipment is inventoried to make sure they have what they think they have.

Many companies never think about the business content as a business asset. The content that’s critical to the business is in Word or Powerpoint files or who knows, saved everywhere: on people’s local computers, somewhere on the network, maybe on a Sharepoint site. No one has any idea how much content they have, much less where it all is or what the most recent version might be.

If you ever wondered what Author-it products do, this is what we do. Our products help you manage your business content as the business asset it is.

In other news

We have a new line-up of free webinars coming your way in April and May. We’re really pleased with the offerings and hope you are too.

High on the list of must attends are 2 in particular:

Content Development: Future Trends, Future Solutions
Paul Trotter, CEO of Author-it Software Corporation shares his vision of the future in this hour long event. You’ll leave knowing what trends are and what you need to prepare for now.
April 25 at 4pm Eastern time.  To sign up for this tools-neutral webinar, click here.

What’s New in Author-it 5.5
Additionally, we have several webinars scheduled to show you what’s coming in Author-it 5.5. To see the times and dates, click here.

by Sharon Burton

TUESDAY, 29 MARCH, 2011

Author-it is hiring!

If you’re interested in joining a really great group of people who actually work together as a team, then we have the place for you. We work hard, but have heaps of fun and there are some great perks to being part of the Author-it team!

Technical Writer – Immediate Start – Head Office, Albany, Auckland, NZ

Author-it is hiring a Technical Writer for their Albany office. This needs to be someone who can really hit the ground running.

Do you have 2+ years experience using Author-it and 4+ years practical experience in writing user documentation for a commercial software product? If this describes you and you can say ‘yes’ to the required skills, knowledge and experience requirements below then, send your CV along with a covering brief on how you think you can make a difference at Author-it.

Skills, Knowledge and Experience

  • Requires the ability to communicate effectively across different levels of understanding (strong interviewing, listening and documentation skills).
  • Strong business and technical acumen with the ability to plan, multi-task and prioritize as well as work flexibly to a deadline.
  • Must have strong user documentation, design and presentation skills.
  • Comfortable in a fast-paced work and cross-functional team environment.
  • Passionate, work smart attitude.
  • Must be detail orientated, can follow directions and established documentation guidelines as well as show a talent for new ideas and continuous improvement.

Technical Requirements

Required:

  • Degree or certification in IT, technical documentation or relevant experience.
  • 2+ years experience using Author-it software products
  • 4+ years practical experience in writing user documentation for a commercial software product.
    • 1+ years experience in writing user documentation for web-based software applications.
    • 1+ years experience using SQL and relational databases (e.g. SQL Server, MySQL, and Oracle).
    • 1+ years experience in using Active Directory and working with Microsoft server software.
    • + years experience working with images and graphics, including design and manipulation.
    • 3+ years practical experience using Microsoft Word, Help systems (e.g., HLP, CHM, WebHelp, JavaHelp) and web technologies (e.g. HTML, XHTML, CSS, XML).
    • 1+ years practical experience in quality assurance.
    • Expert command of English spelling and grammar.
    • Experience with Agile development methodologies and SCRUM.
    • Full understanding of the SDLC.

Preferable:

  • Familiarity with Ext JS or other rich web application frameworks.
  • 1+ years’ experience in writing user documentation for content management software applications.

WEDNESDAY, 23 MARCH, 2011

WritersUA and happenings

WritersUA in Long Beach last week was fun. We met a lot of people in the booth and at the show in general. I got to see our product demo-ed by a fellow who has been showing our products for years and that was a huge learning experience for me. He’s very good.

Author-it Morning was a blast. We had more people than we thought attending and everyone was excited and interested. For half the morning, we threw out our stated agenda and did what the audience wanted to see. One attendee said the morning made the entire show worth her while. Good stuff.

Peer showcases

One of the things I really like about WritersUA is the Peer Showcase event. It’s usually the last day in the food and drink area, making it available to everyone. Selected people get to show something interesting they’re doing and answer questions about it. I sat in a demo by a lovely woman who is creating, on average, 1 user guide a day using Author-it. The way she has everything set up so that she swaps out what needs to swap out and then clicks Publish had me amazed.

She uses Release States for product lines. So, for example, content that is common to all manuals are set to one release state with a color. Content that is specific to each product line is set to other release states and colored differently. That lets her see at a glance what belongs to what. I would never have thought of that and it’s a perfect solution to the problems in her workflow.

Brilliant. Just brilliant.

While I watched her talk about how she did what she did, I realized that Author-it lets the 2 writers do the work of 4 writers. Talk about doing more with less! The ROI for this group of writers was measured in days, I think. And, she said, the rock solid publishing profiles meant that she always got what she expected in the output, saving hours a week in production review.

People swarmed around her table, amazed by the workload and the solution.

Local sightings

I’ll be at the Silicon Valley STC chapter March 24 for a preview of Author-it and other fun stuff, if you’re in the area. I’d love to see you there!

by Sharon Burton

 

TUESDAY, 15 MARCH, 2011

WritersUA Day 1

Not a lot of blogging this week, as we’re at WritersUA in Long Beach.

Sunday, we did the Author-it Morning and had a great time. People got a lot of value out of the 4 or so hours we were together and it was fun.

Today, the booth is very busy and the show attendees are full of excitement.

Watch Twitter for the #writersua keyword to find out what’s going on.

And if you’re at the show, stop by the booth and see what the buzz is all about.

« Newer PostsOlder Posts »
Sharing Buttons by Linksku