Technical writing is an essential skill for civil engineers. Proposals, reports, manuals and other technical documents are a core part of communicating designs, analysis and specifications to clients, government agencies, contractors and the public. Strong technical writing ensures your engineering documents are clear, accurate and professional.
This article provides tips and strategies for civil engineers to improve their technical writing. We’ll cover understanding your audience, using simple language, organizing content, adding visuals, defining terms, editing and proofreading, and building your technical writing skills. Follow these technical writing best practices to create high-quality documents that effectively communicate complex civil engineering concepts.
The first step in technical writing is understanding who will read your document. Identifying your target audience helps shape the language, style, level of detail and graphics you include.
For civil engineering writing, common audiences include:
– Clients – Such as government transportation departments or private sector developers. They want summaries of analysis and recommendations.
– Public – Community residents who will be impacted by a civil project. Graphics and easy-to-understand language is key.
– Regulators – Agencies that oversee engineering standards and safety. Use precise language backed by data and citations.
– Contractors – Who bid on and implement civil designs. Include all necessary technical specifications and instructions.
– Other Engineers – Peers who review designs and proposals. Use accurate technical terminology.
Keep your audience in mind as you write. An environmental impact report for regulators will differ greatly from a project summary for community members. Adjust terminology, detail and emphasis accordingly.
Technical documents contain complex civil engineering concepts. However, they should be written in clear, concise and simple language whenever possible. Follow these guidelines:
– Limit jargon – Define technical terms and avoid unnecessary engineering jargon, particularly when writing for public or client audiences.
– Use active voice – Active voice is easier to read than passive voice. For example, “The engineer designed the bridge” rather than “The bridge was designed by the engineer.”
– Limit acronyms – Spell out terms initially before introducing acronyms, and limit use of obscure acronyms.
– Avoid redundant phrases – Cut unnecessary words. For example, “perform an analysis” can simply be “analyze.”
– Simplify sentences – Break up long, complex sentences into shorter statements with one theme each.
– Be consistent – Use terms and acronyms consistently throughout the document to avoid confusion.
With practice, you can communicate technical details accurately while still being concise and straightforward.
Organization and concise writing enhances the clarity of technical documents. Follow these tips:
– Create an outline first – Develop an outline to organize your content before drafting paragraphs.
– Use descriptive headers – Section headers, subheaders and sidebars help organize topics and make information easy to find.
– Lead with the main point – Start paragraphs and sections with topic sentences that summarize the key message or purpose.
– Omit extraneous details – Leave out info that doesn’t directly support your objectives. Stick to key technical data.
– Use lists – Break up long sections of text with numbered or bulleted lists.
– Be consistent – Organize similar sections using the same structure for consistency.
– Add tables or charts – Simplify complex data as tables, flow charts or diagrams instead of dense paragraphs.
Thoughtful organization and brevity improves the flow of your document and keeps readers engaged.
Headings and bullet points help break up dense technical writing while enhancing readability. Follow these best practices:
For Headers:
– Create descriptive, concise headings that indicate what each section covers
– Use consistent heading formats and hierarchies (Heading 1, Heading 2, etc)
– Avoid headings that simply state the section topic (e.g. “Concrete” or “Loads”). Use descriptive headings (e.g. “Recommended Concrete Mixes for Footings”)
For Bullet Points:
– Use bullet points to list or summarize related information
– Keep bullet points short (1-2 sentences maximum)
– Ensure consistent formatting for all bullet points in a given document
– Consider nested bullets for complex topics to further break down key points
– Use parallel structure so all bullet points are in the same grammatical form
For Example:
Recommended Concrete Mixes for Footings
– 3,000 psi concrete recommended for continuous wall footings
– 4,000 psi concrete recommended for column footings given heavy design loads
– 5,000 psi concrete may be required for footings in severe environments or high seismic zones
– Maximum aggregate size should not exceed 1/5 narrowest dimension between forms
Proper use of headers and bullets improves flow while drawing attention to key information.
Graphics make technical civil engineering concepts easier to understand for non-technical audiences. Charts, diagrams, schematics, drawings and photographs can be used to illustrate designs, explain technical concepts or summarize data.
Follow these best practices when developing graphics:
– Tie graphics back to main document content
– Explain all symbols and abbreviations used in charts, diagrams or drawings
– Number figures sequentially and use descriptive captions
– Place graphics as close to the relevant text as possible
– Keep graphics simple. Avoid cluttered designs.
– Use high resolution images for maximum clarity
– Make sure graphics are legible when printed in black and white, if applicable
– Omit proprietary confidential design details not pertinent to the document
Integrating the right visuals provides clarity and visually reinforces key technical concepts covered in the text.
Even with clear writing, technical civil engineering documents will include specialized technical terms and acronyms. To enhance understanding:
– Spell out the full term initially before introducing the acronym
– Provide definitions for technical terms that may be unfamiliar to readers
– Consider developing a glossary for documents with extensive technical terminology
– Only use common civil engineering acronyms (CSI, ACI, ASTM, etc.) unless required for a technical audience
– Limit use of obscure project-specific acronyms and technical jargon whenever possible
– Remind readers of abbreviations and acronyms that were defined previously if reused later in the document
Defining terms and spelling out acronyms makes technical content more accessible to audiences who are not engineers.
Careful editing and proofreading are essential to produce accurate, high-quality technical documents in civil engineering. Always remember to:
– Check for consistent style, terminology and formatting
– Confirm accuracy of all technical data and calculations
– Verify that graphics and tables support the text and have correct captions
– Review for typos, grammar errors and unclear or awkward wording
– Check that all sections are logical and in the proper sequence
– Have a peer or supervisor also review the document before finalizing
– Proofread again prior to submitting or publishing the final version
Invest time to thoroughly edit and proofread engineering documents to avoid errors that could lead to serious consequences.
Improving technical writing takes practice. Seek opportunities to strengthen your skills:
– Take a writing course – Many engineering firms and universities offer technical writing classes.
– Read examples – Study reports, manuals and other documents written by experienced technical communicators in civil engineering.
– Start a blog – Launch an engineering blog and write regular posts to work on explanatory skills for a broad audience.
– Join writing groups – Look for technical writing workshops or clubs to get feedback.
– Review standards – Read through style guides like the IEEE Professional Communication Standards for best practices.
– Expand your vocabulary – Learn engineering terminology and read up on grammar and syntax rules.
– Solicit feedback – Ask managers, clients and team members for input on how to improve.
Strong technical writing is valued across all engineering disciplines. Hone your skills through practice and advice from professionals to set your civil engineering career up for success.
Clear, well-organized technical documents are vital for civil engineers to accurately convey analysis, designs and specifications. This article has provided 10 tips to enhance technical writing:
1. Know your target audience
2. Use simple, concise language
3. Organize content and be concise
4. Use headers and bullet points
5. Include relevant graphics
6. Define technical terms and acronyms
7. Proofread and edit thoroughly
8. Practice writing regularly
9. Solicit feedback from others
10. Read examples and writing standards
Applying these technical communication best practices will ensure your engineering documents are high-quality and achieve their purpose. Enhance your writing skills throughout your career and become an effective technical communicator.
© 2022 Wimgo, Inc. | All rights reserved.