STE Technical Writing Training Archives | Shufrans TechDocs Home // STE Technical Writing Training Archives | Shufrans TechDocs

The Perilous Afterthought: Why Product Documentation Cannot Be an After-the-Fact Endeavour

The Perilous Afterthought: Why Product Documentation Cannot Be an After-the-Fact Endeavour

In the fast-paced world of product development, especially within critical sectors like aerospace, defence, and manufacturing, the allure of rapid iteration and quick deployment can be overwhelming. However, this urgency often leads to a critical oversight: treating product documentation as an afterthought. This practice, while seemingly efficient in the short term, is a recipe for disaster, a potential malpractice that can have far-reaching consequences.

The Pitfalls of Post-Production Documentation:

  • Inaccurate and Incomplete Information: When documentation is created after the product is finalised, crucial details can be lost or misinterpreted. Developers, having moved on to new projects, may struggle to recall specific design decisions or implementation nuances. This leads to inaccurate or incomplete documentation that fails to serve its intended purpose.
  • Increased Risk of Errors and Accidents: In industries like aerospace and defence, where precision and safety are paramount, inadequate documentation can have catastrophic repercussions. Without clear and comprehensive instructions, operators and maintenance personnel are at a heightened risk of making errors, potentially leading to equipment malfunctions, accidents, and even loss of life.
  • Higher Maintenance and Support Costs: Troubleshooting and maintenance become significantly more complex when documentation is lacking. Support teams spend excessive time deciphering cryptic code or reverse-engineering design flaws, leading to increased costs and prolonged downtime.
  • Compliance and Regulatory Issues: Aerospace, defence, and manufacturing are heavily regulated industries. Comprehensive documentation is often a mandatory requirement for compliance. Failing to provide accurate and up-to-date documentation can result in hefty fines, legal penalties, and even product recalls.
  • Hindered Knowledge Transfer and Training: Effective documentation serves as a vital tool for knowledge transfer and training. When documentation is incomplete or inaccurate, it hinders the ability of new employees and operators to quickly grasp the intricacies of the product, leading to inefficiencies and potential errors.
  • Damage to Reputation and Trust: In industries where reliability and safety are paramount, inadequate documentation can severely damage a company’s reputation and erode customer trust. When customers encounter issues due to poor documentation, they are less likely to rely on the company’s products in the future.

Why This is Malpractice, Especially in Critical Industries:

In aerospace, defence, and manufacturing, the stakes are exceptionally high. Products are often complex, mission-critical, and subject to stringent safety standards. Treating documentation as an afterthought in these sectors is not merely an oversight; it’s a potential malpractice.

  • Safety-Critical Applications: In these industries, products are often used in safety-critical applications where human lives are at stake. Errors resulting from inadequate documentation can have dire consequences.

  • Long Product Lifecycles: Aerospace and defence products often have exceptionally long lifecycles. Proper documentation ensures that the product can be maintained and supported for decades.
  • Complex Regulatory Landscapes: These industries operate within complex regulatory landscapes that demand meticulous documentation. Failure to comply can lead to severe penalties.
  • High Cost of Failure: The cost of failure in these industries is exceptionally high, both in terms of financial losses and potential loss of life.

 

 

The Solution: Integrating Documentation into the Development Process:

The solution lies in integrating documentation into the product development process from the very beginning. By treating documentation as a core component of the product, companies can ensure accuracy, completeness, and consistency.

  • Early Planning and Collaboration: Documentation should be planned and initiated during the early stages of product development, with close collaboration between developers, technical writers, and subject matter experts.
  • Continuous Updates and Revisions: Documentation should be continuously updated and revised throughout the product lifecycle to reflect any changes or modifications.
  • Utilising Modern Documentation Tools: Leveraging modern documentation tools and technologies can streamline the documentation process and improve efficiency.

By prioritising product documentation and integrating it into the development process, companies can mitigate risks, enhance safety, and build trust, particularly in the demanding and critical sectors of aerospace, defence, and manufacturing.

🔗 Analyse your documentation needs and get recommendations and tailor-made solutions to help you establish and improve your documentation processes: https://www.shufrans-techdocs.com/services/consultancy/

Middle East & Africa Online Workshop: ASD-STE100 Simplified Technical English workshop for all industries

Middle East & Africa Online Workshop: ASD-STE100 Simplified Technical English workshop for all industries

ASD-STE100 Simplified Technical English workshop for all industries

Dates: 27 & 28 January 2020

Plan later: 

  1. 19 & 20 February 2020
  2. 4 & 5 March 2020.

Time: 09:00 to 17:00 Gulf Standard Time [MEA]

Length of training: 2 days

Course fee: 450 EUR**

Course registration ends one week before training commences.

**Course fee includes exercises, learning aids, certificate of completion, and 90-day post-training support.

Summary

Simplified Technical English (STE) is a controlled language that is used to write technical manuals in such a way that they can be more easily understood by an international audience. STE helps to make translations cheaper and more accurate. Often a formal requirement for aircraft and defence maintenance documentation, STE can easily be adapted to all technical industries and beyond. Ms. Shumin Chen will teach participants how to correctly and effectively use STE in practice. She will also address some of the mistakes commonly found in technical writing and the frequently incorrect use of common STE writing rules.

I’ve found all the rules introduced in this workshop equally valuable and applicable in my field of work. The ASD-STE100 Specification is very useful for searching examples and finding STE compliant alternatives. It was also great that we has such a large number of practical exercises. Personally, it would be more valuable to have more context available. This helps us judge how to apply STE optimally. Thank you Shumin! Your workshop was concise, clear, and pragmatic. I also liked the occasional humour! 🙂 Diane Goodrick, Information Architect/ Author Trainer, Schindler Group.

Course outline*

  • Day 1: Classroom Training
    1. Practical overview of Simplified Technical English
    2. How STE helps both native & non-native speakers of English
    3. Benefits of adopting the STE international writing standard
    4. Writing rules and how to apply them in practice
    5. How to use the general vocabulary.
    6. Approved and non-approved words discussion and the rationale behind.
  • Day 2: Application, Review, & Exercises
    1. How to deal with industry-specific terminology
    2. How to use STE for various documentation types
    3. How to implement STE with minimal disruption to on-going production and existing documentation
    4. Practical workshop session for applying STE rules to your own documents
    5. Review, edit, and discuss participants’ own documents to reinforce learning
    6. Classroom presentation of own documents.

* Shufrans also offers customised ASD-STE100 training solutions tailored to meet your specific requirements. These courses are normally provided at the customer’s premises.

 

Who should attend?

  • Compliance managers
  • CIO, COO, CTO
  • Customer support managers
  • Documentation managers
  • Editors
  • Engineering managers
  • Engineers and SMEs who create documentation
  • Graphics specialists
  • ILS managers
  • Maintenance managers
  • Operation managers
  • Product managers
  • Project managers
  • Quality managers
  • Software research engineers
  • Technical illustrators
  • Technical writers
  • Translation managers
  • Translators.

What training outcomes to expect?

Our interactive training, exercises and workshop, will teach participants to standardise content to:

  • Author more efficiently
  • Communicate more effectively with a global audience
  • Improve operational safety
  • Reduce AOG / downtime
  • Facilitate modular writing and reuse
  • Facilitate teamwork
  • Facilitate translation
  • Maximise consistency
  • Optimise product lifecycle support
  • Reduce the cost of creating and maintaining technical publications.

Trainer’s qualifications

Ms. Shumin Chen, principal trainer & consultant at Shufrans TechDocs received her professional on-the-job training in the field of STE under the tutelage of Dr Frans Wijma, a linguist and documentation expert. Together as an experienced global team, they provided their combined knowledge and dedication to benefit customers worldwide. To date, they have provided training and consultancy services to over 180 companies. Shufrans TechDocs is the only company with such vast experience in providing certified STE training.

Shumin has supported various companies with their STE and other documentation needs, based on standards where possible. Although STE was developed for the aerospace industry, more specifically for aircraft maintenance documentation, Shumin found that it made a lot of sense to apply the same principles to other industries and types of documents as well. Few -if any- changes to the specification are necessary to adapt STE to industries ranging from machinery to IT, automotive to medical equipment.

 

APAC Online Workshop: Write effective user manuals & instructions with Simplified Technical English

APAC Online Workshop: Write effective user manuals & instructions with Simplified Technical English

Write effective user manuals & instructions with Simplified Technical English

Dates:  3 & 4 February 2020

Plan later: 

  1. 27 & 28 February 2020.

Time: 09:00 to 17:00 UTC/GMT +08:00 [Asia Pacific]

Length of training: 2 days

Course fee: 450 EUR**

Course registration ends one week before training commences.

**Course fee includes exercises, learning aids, certificate of completion, and 90-day post-training support.

Summary

Simplified Technical English (STE) is a controlled language that is used to write technical manuals in such a way that they can be more easily understood by an international audience. STE helps to make translations cheaper and more accurate. Often a formal requirement for aircraft and defence maintenance documentation, STE can easily be adapted to all technical industries and beyond. Ms. Shumin Chen will teach participants how to correctly and effectively use STE in practice. She will also address some of the mistakes commonly found in technical writing and the frequently incorrect use of common STE writing rules.

Shumin gave us a an all-rounded presentation to Simplified Technical English. Personally, rule 1.3: To use only approved words with their approved meaning holds the key to successful controlled language implementation. Rules 3.4, 3.6, 4.1, 5.3, and 5.5 are also among my favourites. The approved verb TO MAKE SURE THAT can come in very handy for technical writers as well. The presentation of STE rules offers quite a detailed overview that includes not only language rules but good, old technical authoring principles in general. It has been very helpful for us to learn and understand the concept of STE. I have found Shumin to be very competent in STE and will defnitely recommend her course! Eric, Head of Corporate Technical Documentation (CTD), Schindler Group.

Course outline*

  • Day 1: Classroom Training
    1. Practical overview of Simplified Technical English
    2. How STE helps both native & non-native speakers of English
    3. Benefits of adopting the STE international writing standard
    4. Writing rules and how to apply them in practice
    5. How to use the general vocabulary.
    6. Approved and non-approved words discussion and the rationale behind.
  • Day 2: Application, Review, & Exercises
    1. How to deal with industry-specific terminology
    2. How to use STE for various documentation types
    3. How to implement STE with minimal disruption to on-going production and existing documentation
    4. Practical workshop session for applying STE rules to your own documents
    5. Review, edit, and discuss participants’ own documents to reinforce learning
    6. Classroom presentation of own documents.

* Shufrans also offers customised ASD-STE100 training solutions tailored to meet your specific requirements. These courses are normally provided at the customer’s premises.

Who should attend?

  • Compliance managers
  • CIO, COO, CTO
  • Customer support managers
  • Documentation managers
  • Editors
  • Engineering managers
  • Engineers and SMEs who create documentation
  • Graphics specialists
  • ILS managers
  • Maintenance managers
  • Operation managers
  • Product managers
  • Project managers
  • Quality managers
  • Software research engineers
  • Technical illustrators
  • Technical writers
  • Translation managers
  • Translators.

What training outcomes to expect?

Our interactive training, exercises and workshop, will teach participants to standardise content to:

  • Author more efficiently
  • Communicate more effectively with a global audience
  • Improve operational safety
  • Reduce AOG / downtime
  • Facilitate modular writing and reuse
  • Facilitate teamwork
  • Facilitate translation
  • Maximise consistency
  • Optimise product lifecycle support
  • Reduce the cost of creating and maintaining technical publications.

Trainer’s qualifications

Ms. Shumin Chen, principal trainer & consultant at Shufrans TechDocs received her professional on-the-job training in the field of STE under the tutelage of Dr Frans Wijma, a linguist and documentation expert. Together as an experienced global team, they provided their combined knowledge and dedication to benefit customers worldwide. To date, they have provided training and consultancy services to over 180 companies. Shufrans TechDocs is the only company with such vast experience in providing certified STE training.

Shumin has supported various companies with their STE and other documentation needs, based on standards where possible. Although STE was developed for the aerospace industry, more specifically for aircraft maintenance documentation, Shumin found that it made a lot of sense to apply the same principles to other industries and types of documents as well. Few -if any- changes to the specification are necessary to adapt STE to industries ranging from machinery to IT, automotive to medical equipment.