Blog

Technical writing requires the communication of technical information and processes succinctly, accurately and clearly. While this can involve technical detail and step-by-step instructions, the success of each technical writing project has another hugely influential factor … humans.

When working on a technical writing project, the Orchid team takes time to talk to clients. It’s vital to ask key questions. The authoring team needs to know the processes and/or the product involved and what issues must be addressed in the technical documentation requested. Crucially it isn’t just what needs to be communicated that’s involved. We must understand how the messages should be expressed for optimum efficiency and user experience. Then, we can carefully prepare our draft document.

Communicating technical messages involves creating templates, word lists for correct terminology, presentation styles and standards. Drawing options are also considered, such as illustrations, exploded parts diagrams and graphics. Online material may include animation or video (especially valuable within e-Learning solutions).

Once these standards have been established and approved, they can be applied across several technical documents for consistency throughout the organisation.

The learning curve bringing the authoring team to this point involves time and careful communication. These elements add value and quality to the resulting technical documentation. Having reached this understanding and knowledge, the authoring team can react more quickly to future client requirements. It’s also fair to say that communication becomes more effective as styles and preferred methods are known. Some people prefer to meet, others are happy to talk online, for example. Once the authoring team is familiar with the product vocabulary involved, discussions take less time.

At Orchid, we value the long standing relationships we have with many of our clients. We are happy to write a ‘one-off’ technical document. However, ongoing work undoubtedly improves communication and saves time due to existing knowledge.

A strong, ongoing working relationship with clients helps us to:

These efficiencies enable each project to become more cost effective, offering potential savings to clients.

The presentation, accuracy and effectiveness of the technical writing are crucial, however human communication is also vital to success. Ongoing client relationships streamline this potential.

Contact the Orchid team without obligation. We’ve been writing technical user guides for over 30 years, working with a wide range of clients, often for many years. Let’s explore the best solutions for your organisation.

If you’ve used a user guide to assemble a product, you’ve probably seen an exploded parts diagram.

An exploded parts diagram or illustration is a visual representation of the individual components of a mechanical or technical object. It offers a separated display, with the various parts of the object illustrated outside their normal assembled position.

The purpose of an exploded parts diagram is to provide a clear and detailed view of how the different components fit together to form the complete object. They often include lines showing where each component is usually placed, demonstrating the spatial relationships of connecting parts.

This type of diagram is commonly used in technical documentation, such as user manuals, assembly instructions, repair guides, and engineering drawings. The Orchid team often creates exploded parts illustrations to support technical writing for clients’ documentation. 

• Individual Components: Each part of the object is shown separately, usually with unique identification such as a specific number or letter. Identification is helpful for reordering of parts during servicing or repair, for example.
• Spatial Relationships: Exploded parts diagrams show where each component is usually placed, the parts it connects with and its spatial relationships with these connecting parts.
• Accurate Product Representation: The diagram is designed to be easily understandable, allowing users or technicians to see the internal structure of the object and how parts interact without disassembling it. (Some parts of the product may not be visible before disassembly.)
• Assembly Instructions: Exploded parts diagrams are commonly used to guide users through the process of assembling or disassembling a product (using the unique reference of each component).
• Technical Details: The exploded parts illustration may include additional technical details, such as part numbers, materials, and other relevant information.
• User-Friendly Design: Exploded views are often created with a user-friendly design, making them accessible to a wide audience, including individuals who may not have a deep technical background. This is where the Orchid team excels!

These diagrams are particularly useful in fields such as engineering, manufacturing, and product design. The Orchid team has designed exploded parts diagrams for clients in industrial tooling, consumer products, military aviation and many more sectors.

Five ways to use exploded parts illustrations

The Orchid team can produce exploded parts illustrations using a variety of formats. Organisations may choose from traditional line illustrations with simple 2D plan views to complex 3D perspective views in a digital format ready to print. Software-based solutions offer a ‘click & explode’ option. This is especially helpful in showing the internal structure of a product.

To discover the options and the best format for your organisation’s product, talk to the team at Orchid. We have vast experience in creating practical, easy-to-use exploded parts diagrams using drawing, software and automation for a wide variety of industries. Contact us without obligation.

Arrival at clients’ premises often involves an induction process. The Orchid team has experienced many safety inductions, some paper-based and others online. Our director, Keith Glanville, outlines what was involved with two visits, one involving eLearning and the other using a paper-based approach.

We thought we’d share Keith’s experience, as these first-hand stories illustrate the impact of eLearning, or CBT, upon people and processes.

Keith visited a large site where waste material was processed. He needed to update some operating procedures and be able to walk around the site unaccompanied.

On arrival, and already wearing PPE, Keith was shown to a portable cabin where he was asked to wait until the person conducting safety inductions arrived. After half an hour, they arrived with an old binder containing plastic wallets and some Question and Answer papers.

Keith says: “I was taken through the faded content of several slightly soiled and dog-eared plastic wallets, containing training sheets on PPE, fire alarms, assembly areas and more topics. After reading the content, I was asked to complete a Question and Answer sheet. It was a multi-choice sheet and took ten minutes to finish. Half an hour later, the safety induction person reappeared. He graded my paper – I passed! I was asked to sign the conditions on the form and issued with my site pass. My form was dropped into an overflowing basket on the desk.”

Whilst this induction process achieved the overall objective, it was cumbersome and time consuming.

Keith visited a large manufacturing site to obtain machine maintenance information. Before the visit, he received a link to their online induction system. Creating his account took just a few minutes. The next step was to complete the training.

“The online training involved well-presented informational screens,“ explains Keith. “Scenarios followed each section using videos and animations. I was asked to confirm what action would be the best in each situation. As I answered the questions, the system offered advice on what would have been the recommended action. I could leave the training and return to it later. The software recorded my position, so I carried on from where I’d left off.”

After completing the training, Keith completed an interactive test. On reaching the pass requirement, he received a certificate via email. This was presented at the start of the site visit. He was invited to refresh his training as necessary.

This induction process offered flexibility and convenience alongside automated assessment recording.

Both scenarios reflect a real experience. Each approach achieved the overall objective of completing a safety induction for a site visit. However, the second experience offered distinct advantages:

• The online training was consistent, informative and engaging.
• Keith could complete the training in his own time before arriving on site.
• No extra time was needed upon arrival – from Keith or a company employee.
• The eLearning system maintained a record of the training for future use.
• The eLearning system had the facility to be revisited.
• Email reminders could be issued when necessary.

Orchid can help ensure your safety inductions have flexibility, consistency and engagement by creating a well-presented eLearning solution. This is also known as Computer Based Training (CBT) and offers scalability and compliance benefits (read more).

To discuss how eLearning can optimise your organisation’s induction and training processes, contact the friendly experts at Orchid without obligation.

Product user guides play a crucial role in ensuring users can effectively and safely use a product. This technical writing can be created for customers and/or internal use (employees).

They bridge the gap between the manufacturer’s knowledge and the users’ understanding, contributing to a positive user experience and minimising potential issues.

Typically, the following sections are included within user guides:

• Title – with a product identification image
• Safety section
• Product overview – key components
• Product description – function, features & benefits, any controls & indicators
• Normal operation / Instructions for use
• Maintenance (and cleaning) / Spare parts
• Warranty, certification and manufacturer’s information
• Servicing & support

The above user guide sections are adjusted to suit the product, users and organisation involved. The best user guide results involve the support of technical writing experts.

Would your organisation benefit from professionally written user guides?

Contact the Orchid team without obligation. We’ve been writing technical user guides for over 30 years within a wide range of sectors. Let’s explore the best solutions for your organisation.

A great onboarding process improves employee retention by 82%.

The research by Brandon Hall Group explains: “Companies with weak onboarding programs lose the confidence of their candidates and are more likely to lose these individuals in the first year.’

One of the keys to successfully introducing new employees to an organisation is utilising tools and technology to help a new employee succeed.

This is where Computer Based Training (CBT) – or e-Learning – benefits organisations and employees significantly. E-Learning increases information retention rates by up to 60%, compared to 8-10% for traditional learning. (Oxford Learning College)

While Computer Based Training offers numerous benefits, it’s important to note that a well-rounded onboarding program may incorporate a mix of methods. These could include face-to-face interactions and hands-on experiences, for example. CBT is an important element of a

comprehensive, efficient and cost effective onboarding experience. It is especially helpful to larger organisations with a higher number of new employees.

Would you like a streamlined, scalable onboarding system for your organisation?

Would you like to explore the potential of CBT onboarding? Talk to the team at Orchid without cost or obligation. Let’s discover how CBT can help you.

Why do I need Operating Procedures? This is a question often asked by Operations Managers working at a manufacturing or process plant.

Our answer is another question: Why is there any doubt?

It’s easy to assume that everyone in your team knows what their job is and understands exactly what they need to do. Potentially, these factors remove the need to document procedures. However, human beings need reference points and reminders. People need professionally produced Operating Procedures.

A carefully written Operating Procedure distils a work process into clear step-by-step instructions. Plus, there are other important advantages to be gained.

Why do I need Operating Procedures? We hope we’ve offered great reasons for using clear, easy-to-follow processes within your business. We’ve seen how much Operating Procedures help businesses by offering consistency, safety and growth.

Explore how well-written Operating Procedures can help your team and business. Contact us for an initial discussion without obligation or cost. Let’s explore a better way.