freelance technical writer

Editing and Proofreading from CohenWrite in Greenwich CT

Posted by | editing, freelance technical writer, mobile user assistance, Online Help Writer, proofreading, Software User Assistance, technical documentation in Greenwich CT, technical writing | No Comments

In today’s business environment, urgency is often the primary motivator behind new product releases, especially in the software and mobile application development realms. In the rush to be the first to market with the latest and greatest, important steps are often skipped in the process. Editing and proofreading of written supporting material such as end user documentation, marketing copy and even press releases are steps that I’ve seen skipped or at best, hurried through. The result is a product that might look unfinished to many, and that’s no way to hit the market with your great new product.

CohenWrite offers more than 25 years of experience proofreading and editing, and we always deliver when you need it. Let us put that professional final touch onto your written material, including technical documentation, web content, software user assistance, mobile user assistance and more.

API Documentation in Greenwich CT

Posted by | API documentation, freelance technical writer, technical documentation in Greenwich CT, technical writing, Uncategorized, writing services in Greenwich CT | No Comments

Having worked in the software industry for oh, forever, I’ve worked with a lot of software developers. And there is a universal truth in the realm of software development: Programmers hate to write documentation. Even those developers who begin a project with the best of intentions end of stumbling somewhere along the way, and the code that is ultimately produced contains little or no useful documentation. But ironically, software developers LOVE good API documentation.

Well, of course they do. Good API documentation leads a programmer by the hand through the jungle of functions, methods, events, parameters and yes, the dreaded best practices. The best API documentation should include the following elements:

  • Completeness. Every aspect of an API should be documented.
  • Examples. This is very important.
  • Sample applications, if available.
  • Ease of use and accessibility. API Documentation is best presented in an online format with lots of related links, easily accessible to the busy, impatient programmer.
  • Coverage of multiple languages, if applicable and practical.
  • Documentation of error codes.

CohenWrite has a lot of experience working with software developers and API documentation. Let us help you help your developers.

Webinar Planning and Scripting from Technical Writer in Greenwich, CT

Posted by | freelance technical writer, Online Help Writer, Software User Assistance, technical documentation in Greenwich CT, technical writing, Web-based user assistance, webinar planning and scripting, writing services in Greenwich CT | No Comments

By now we’ve all heard of web conferencing, that ubiquitous service that allows conferencing events to be shared with remote locations over the Internet. The modern term for this service is Webinar, and they have become both popular and quite useful for customers of all kinds of companies.

Webinars are often presented as a combination of software demonstration and PowerPoint presentations, and frequently provide some form of take-away document at the end. The take-away document can be the actual PowerPoint presentation, which can be problematic if the presentation is too wordy, too vague, or doesn’t have enough meaningful images; or an additional document specifically designed for this purpose. One of the most popular webinar services is Webex, which is a proprietary service from Cisco.

Some web conferencing solutions require that additional software be installed by the presenter and participants. Some web conferencing vendors provide a complete solution while others just enhance existing technologies. Participants can be individuals or a group. The best webinar systems allow individuals to interact with the presenter by means of a chat panel, in which the attendees can ask questions that are seen live by the presenter. Many webinar vendors provide either a recorded copy of an event, or a means for a subscriber to record an event. In my experience, the majority of people who register for a webinar end up not attending but going back later and watching or downloading the recording of the event. So the ability to record webinars is very important.

Of course the most important aspect of a webinar is the actual presentation. Is it focused on a single piece of software or logical group of software functions? Is there a demonstration of the software? If there are slides to present, are they useful and capture the attention of the attendees?

Webinars can be a very cool way to impart important information to your customers about what your product does, how it works, and how to use it. Shorter webinars are usually more effective than longer webinars because quite honestly, most people are busy, multi-tasking, or simply lose focus after too much time. Of courser, a good writer can provide webinar planning and scripting, and some, this author included, can even do justice to the presentation.

Useful and Interesting Stuff Around the Web: from Technical Writer in Greenwich CT

Posted by | Content Strategy, freelance technical writer, Online Help Writer, Software User Assistance, technical documentation in Greenwich CT, technical writing, writing services in Greenwich CT | No Comments

There’s a lot of useful and interesting stuff floating around the web these days on a variety of topics, particularly those of interest to businesses who are thinking about how to present information to their customers. Unfortunately, there’s so much lousy and wasteful content out there, most people give up trying to find the good content.

Here then, are a few links to some articles and blog posts that I found useful and interesting, and I hope you do too:

A collective thanks to the authors of the aforementioned articles.

Technical documentation writing services in Greenwich CT

Posted by | freelance technical writer, Online Help Writer, Software User Assistance, technical documentation in Greenwich CT, technical writing, Uncategorized, writing services in Greenwich CT | No Comments

CohenWrite is backed by more than 25 years experience writing documentation for software and hardware products using a variety of popular authoring tools. In the “old days,” we used to write long-hand content and hand it over to a typist who prepared printed pages on a Xerox 860 system. Now we use all kinds of sophisticated single-based authoring software to prepare the widest variety of content to software users over the Internet.  The tools may have changed, but the fundamental principles underlying documentation content have not. End users still need to know how to get the most of out of your product. This is the value that experienced technical writers add to your product and your company.

Technical documentation includes but is not limited to:

  • Step-by-by procedural manuals
  • Online help
  • Immediate help embedded in the software itself
  • Conceptual information
  • Visual learning guides
  • Collaborative documentation
  • Information for programmers (API guides, for example)
  • Training guides

And the list goes on.

Twiki content planning and authoring in Greenwich CT

Posted by | freelance technical writer, technical writing, twiki planning and authoring, writing services in Greenwich CT | No Comments

We’ve all used a wiki at one or another, either at work or on the Internet. The most popular example of wiki technology is wikipedia.org, everybody’s favorite online encyclopedia. Its most basic application is collaborative authoring, and this writer has been involved in the planning and authoring of wiki content using one “brand” of wiki – Twiki. But most wiki software works the same way.

A wiki is an application accessed in a web browser. It allows people to add, delete or change content in a collaborative environment. Wiki authors enter text using a simplified format and the structure of the information is usually created based on the needs of the participants. Wikis can be used to manage content and a single author does not typically control that content. Many authors contribute to the content.

Twiki is a wonderful tool and is often overlooked. However, smart companies know the value of this tool. Using a wiki to dispense and share information can greatly enhance the collective knowledgebase of an organization by allowing active and regular collaboration among software developers, writers, marketing staff and indeed, every department and employee. Everyone in an organization can post, read and add comments to coding notes, testing protocols and results, product specifications, internal documentation, meeting notes, scheduling, metrics and a whole lot more. It’s really simple: important information disseminated to more employees makes them smarter.

Wikis are often used as the basis for websites, presenting content to the public (Wikipedia) or even functioning as customer service portals where customers can post questions and issues and service reps can respond with solutions.

To summarize, most organizations could benefit from implementing a wiki in one form or another.

Web-based user assistance – technical writing in Greenwich CT

Posted by | freelance technical writer, Online Help Writer, Software User Assistance, technical writing, Web-based user assistance, writing services in Greenwich CT | No Comments

These days, user assistance comes in many forms. We still produce traditional sources of assistance for our customers in the form of sequentially organized printable user manuals and online help systems. But web-based assistance – that is, content that is viewed in a web browser – has become more and more common, and not just for web-based applications.

Go to any website that sells any product. Many will feature “online help” that appears directly on the web page when a customer clicks a link or a menu command. This kind of web-based help is often quite effective when displayed in its own panel or other type of container directly on the page. A single click gives the user access to the correct information exactly when he or she needs it, rather than forcing the user to go dig around in some 500-page PDF manual or click around in an external help system. And we’re all familiar with the ubiquitous Frequently Asked Questions pages at our favorite online shopping hangout.

Then there are web-based software applications, which often provide different kinds of user assistance. While an external help system remains a traditional solution to user assistance for web-based apps, including in-depth procedural and conceptual information, this type of system does have some drawbacks. For example, it sits outside of the application itself and a user must take multiple steps to find the right information, removing their focus from the task at hand in the application. Testing consistently finds that most users do not use the help system at all after failing once to find relevant information.

The best way to provide user assistance for web-based application is to embed the information directly in the application user interface. Finding answers to questions in embedded user assistance takes almost no effort – the information is usually right there on the screen, or appears directly on the screen with a single, obvious click. Again, testing consistently finds that users are more likely to use embedded help than an external help system.

The lesson here? Web-used user assistance is preferable to external help systems, or at the very least, should be the first line of defense for a confused user.

Online and printable end user guides technical writing

Posted by | freelance technical writer, Online Help Writer, Software User Assistance, technical writing, writing services in Greenwich CT | No Comments

Even though the advent of social media and customer feedback and interaction has begun to change the way software help is delivered, most software companies still produce online and printable user guides.  CohenWrite is backed by 25 years of experience authoring end user guides using the most popular documentation authoring tools, including Madcap Flare, Adobe FrameMaker, RoboHelp and yes, even Microsoft Word. Current versions of these tools allow authors to output multiple deliverables from a single set of source files, making the process of producing and delivering information to suit your audience fairly painless.

Customers who buy your software applications, whatever they are, still need to know how to use them. They still need to know step-step-procedures, identify user interface elements, and understand how to get the most out of your product. End user guides, especially when delivered online and embedded in the software itself, still serves this purpose when designed properly, with the needs of the end user in mind.

CohenWrite can produce all of your end user guides using modern authoring tools, helping you to deliver the right information to your customers at the right time.

Software user assistance technical writing services in Greenwich CT

Posted by | freelance technical writer, Online Help Writer, Software User Assistance, technical writing, writing services in Greenwich CT | No Comments

Software User Assistance is one of those phrases created in the modern information age to describe both the process of developing information to support software users and the information itself. Software user assistance has many names, online help being the best known and most commonly accessed from any software program by pressing the F1 key on a keyboard.

In a former age, technical writers created printed documentation for software users. You remember those multiple, large volumes of instructions that required a big shipping box to hold them. These manuals invariably sat for years on your office bookshelf, often unopened and unread. If you did read them, you would probably jump right to the index and hope to find something useful. Then with the aid of newer, more robust authoring tools, we added online help to the mix of user assistance outputs. Online help provided software users with a dedicated window of content, context-sensitive to the software function you were currently using. The great thing about online help was that it allowed content to be driven by the needs of the user; hyperlinks connected related topics of information in a non-linear structure. The advent of modern documentation tools allowed us to produce printed and online outputs from a single source of information, and provide a more dynamic online help experience. The Internet has provided for an even richer user experience, allowing for dynamic information updates and a variety of information formats and presentations, including more and better images and video. More recently, the explosion of social media has given our users the ability to contribute to the documentation through the use of information feedback and sharing.

Technical writers are the traditional authors of software user assistance, but technical writing is only one of the skills now required to write good software documentation. These days, software user assistance skills can now include technical writing, user interface design and usability, editing, project planning, coding, indexing, testing, localization and standards.

Today, software user assistance is a very broad term and encompasses any and all content provided to users to help them get the most of the software that you have sold them. And it is a critical part of your user’s experience.

Welcome to CohenWrite – Professional Writing Services

Posted by | freelance technical writer, Online Help Writer, Software User Assistance, technical writing, writing services in Greenwich CT | No Comments

Welcome to CohenWrite!

CohenWrite provides professional writing services in the areas of Software User Assistance, Technical Documentation, Marketing and Advertising Copy, SEO-Friendly Website Content, Content Strategy, User Education, and Editing to companies large and small who lack the internal resources to generate such content themselves.

After decades of providing content as an employee of businesses in a wide variety of industries, I am bringing my expertise to the wider world as a consultant. Check out some of the pages on this site to learn more about me and what I can do for you:

  • Read about my background on the About and Biography pages.
  • Take a look at some of the companies for whom I have written in the past on the Clients & Samples page.
  • And take a look at the kinds of writing I can provide to help your business grow on the Services page.