Subject » BMEVIHIAV51
Technical Communication in Industry and Academia
Műszaki kommunikáció az iparban és a tudományos életben
A tantárgyleírás hatályossága
Hatályosság kezdete:
2026. March 21.
Hatályosság vége:
—
| Subject name (Hungarian, English) |
Műszaki kommunikáció az iparban és a tudományos életben
Technical Communication in Industry and Academia
|
||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Subject code | BMEVIHIAV51 | ||||||||||||
| Subject type | — | ||||||||||||
| Training Level | — | ||||||||||||
| Course types and hours (weekly/semester) |
|
||||||||||||
| Assessment type | félévközi érdemjegy | ||||||||||||
| Credits | 2 | ||||||||||||
| Subject coordinator |
Dr. Kara Péter András
position: adjunktus
contact:
kara.peter.andras@vik.bme.hu
|
||||||||||||
| Responsible department |
Hálózati Rendszerek és Szolgáltatások Tanszék
|
||||||||||||
| Faculty | Villamosmérnöki és Informatikai Kar | ||||||||||||
| Subject website | — | ||||||||||||
| Primary curriculum type | — | ||||||||||||
| Direct prerequisites – Strong prerequisite | none | ||||||||||||
| Direct prerequisites – Weak prerequisite | none | ||||||||||||
| Direct prerequisites – Parallel prerequisite | none | ||||||||||||
| Direct prerequisites – Milestone prerequisite | none | ||||||||||||
| Direct prerequisites – Exclusion | none |
Objectives
Programme
The course aims to provide skills and knowledge needed to create and maintain user-friendly technical documentation. Students will learn about to the history of technical documentation and its different types and uses. They will understand the language and structure requirements used for different industries. In addition, the most common mark-up languages, content management software, word processors and graphic tools used for documentation will be introduced. Students will also gain an insight into technical writing workflows and the most practical methods of communication and research. This course will also focus on how to handle end-user feedback when writing documentation.
On successful completion of the course, students will acquire the skills to produce complex, modular technical texts in both print and digital formats. Based on the technical information received, they will be able to make structural and linguistic changes to the text using the tools available, meeting the industry's requirements in terms of content and format.
With regard to academic writing, each topic of technical writing is also addressed in terms of scientific publishing, and the course highlights best practices and calls attention to common mistakes.
Responsibilities related to the editing and proofreading are analyzed and discussed through specific examples written in some of the most prevalent publishing templates of the global scientific community. The contents of the course do not overlap with VIHIAV44 (Publication of Scientific Papers), but serve as extension from the perspective of technical communication.
Throughout the semester, the course invites various experts from the industry to provide additional insights regarding the standardized procedures of technical communication and the related best practices. The synopsis of the course is composed of nine main topics:
Topic 1: Development and significance of technical writing (weeks 1)
What is technical writing?
How did technical writing evolve?
What are the primary characteristics of technical writing and academic publishing?
Topic 2: The lifecycle of a technical document (weeks 2 and 3)
How is a new document produced?
What are the types of technical input, and how to process them?
What are technical and editorial changes?
What are user personas?
What is the technical writing workflow?
What is the docs-as-code approach?
How can AI technology be used in the different phases of document creation?
How do academic authors create a scientific paper together?
Topic 3: Language and structural requirements (week 4)
How does the style of technical writing differ from other writing styles?
What are the linguistic, stylistic, and structural requirements of technical writing?
What are the common linguistic and template-independent requirements of scientific papers?
Topic 4: Structured authoring: markup languages and word processors (weeks 5 and 6)
What are markup languages such as XML?
How to use the DITA methodology to create content?
What are the basics of content management software?
What are the state-of-the-art solutions for word processing in industry and academia?
Topic 5: Technical illustrations and unstructured authoring (week 7)
Why are graphics and animation important in technical texts?
What are the most important layout and typographic rules for printed texts?
What paper-related choices do academic authors have when they strictly follow the templates of scientific venues?
Topic 6: Intelligent content in technical writing (week 8)
How to create technical content that can be easily processed by AI tools?
What is the current status of AI usage in technical writing?
How to ethically use AI in scientific publishing, and how to avoid potential AI-related errors?
Topic 7: Editing basics (week 9)
What is the aim of a review and how is it carried out?
What are the differences between the review process in the industry and academia?
What are the different levels of editing?
How to maintain unified writing in scientific papers?
What editing is required for conference and journal papers?
Topic 8: Grammar in scientific publishing (weeks 10 and 11)
Which grammatical tense to use in a given context?
How to refer to prior scientific work?
How to select the correct punctuation for the sentence?
How long should a single sentence be?
How to write for a specific audience?
Topic 9: Common mistakes in writing scientific papers (week 12)
What are the most common mistakes that can degrade the quality of the paper?
Topic 10: Examples of camera-ready and published papers (weeks 13 and 14)
How to address editing- and proofreading-related responsibilities?
How to fine-tune a paper without deviating from the template?
On successful completion of the course, students will acquire the skills to produce complex, modular technical texts in both print and digital formats. Based on the technical information received, they will be able to make structural and linguistic changes to the text using the tools available, meeting the industry's requirements in terms of content and format.
With regard to academic writing, each topic of technical writing is also addressed in terms of scientific publishing, and the course highlights best practices and calls attention to common mistakes.
Responsibilities related to the editing and proofreading are analyzed and discussed through specific examples written in some of the most prevalent publishing templates of the global scientific community. The contents of the course do not overlap with VIHIAV44 (Publication of Scientific Papers), but serve as extension from the perspective of technical communication.
Throughout the semester, the course invites various experts from the industry to provide additional insights regarding the standardized procedures of technical communication and the related best practices. The synopsis of the course is composed of nine main topics:
Topic 1: Development and significance of technical writing (weeks 1)
What is technical writing?
How did technical writing evolve?
What are the primary characteristics of technical writing and academic publishing?
Topic 2: The lifecycle of a technical document (weeks 2 and 3)
How is a new document produced?
What are the types of technical input, and how to process them?
What are technical and editorial changes?
What are user personas?
What is the technical writing workflow?
What is the docs-as-code approach?
How can AI technology be used in the different phases of document creation?
How do academic authors create a scientific paper together?
Topic 3: Language and structural requirements (week 4)
How does the style of technical writing differ from other writing styles?
What are the linguistic, stylistic, and structural requirements of technical writing?
What are the common linguistic and template-independent requirements of scientific papers?
Topic 4: Structured authoring: markup languages and word processors (weeks 5 and 6)
What are markup languages such as XML?
How to use the DITA methodology to create content?
What are the basics of content management software?
What are the state-of-the-art solutions for word processing in industry and academia?
Topic 5: Technical illustrations and unstructured authoring (week 7)
Why are graphics and animation important in technical texts?
What are the most important layout and typographic rules for printed texts?
What paper-related choices do academic authors have when they strictly follow the templates of scientific venues?
Topic 6: Intelligent content in technical writing (week 8)
How to create technical content that can be easily processed by AI tools?
What is the current status of AI usage in technical writing?
How to ethically use AI in scientific publishing, and how to avoid potential AI-related errors?
Topic 7: Editing basics (week 9)
What is the aim of a review and how is it carried out?
What are the differences between the review process in the industry and academia?
What are the different levels of editing?
How to maintain unified writing in scientific papers?
What editing is required for conference and journal papers?
Topic 8: Grammar in scientific publishing (weeks 10 and 11)
Which grammatical tense to use in a given context?
How to refer to prior scientific work?
How to select the correct punctuation for the sentence?
How long should a single sentence be?
How to write for a specific audience?
Topic 9: Common mistakes in writing scientific papers (week 12)
What are the most common mistakes that can degrade the quality of the paper?
Topic 10: Examples of camera-ready and published papers (weeks 13 and 14)
How to address editing- and proofreading-related responsibilities?
How to fine-tune a paper without deviating from the template?
The goal of the course is to enable an in-depth understanding of the necessary structure, style, and modularity of modern technical documentation. To support these tasks, the course provides an introduction to the history and principles of technical writing, input research, documentation drafting, revision processes, readability and accessibility of written texts, and basic technologies involved. Upon satisfactory completion of the course, students will be able to do the following:
• Design effective technical documents for both print and digital media.
• Restructure and rewrite the received input to improve quality and user experience.
• Understand the flow of information necessary for quality technical documentation.
• Understand what makes content easily processable by AI technology.
• Understand and use different means of information architecture appropriate to technical documents in digital environments.
• Understand and use a range of current tools and technologies connected to technical writing.
• Understand the importance of technical illustration and instructional design.
Additionally, the course addresses technical writing in academia. The aim of the corresponding lectures is to improve skills that are necessary to enhance the quality of conference and journal papers on the level of technical communication, and thus, to increase the competitiveness of such manuscripts in peer-reviewed publishing.
Learning outcomes
Ez a tantárgy a KKK rendeletben meghatározott, következő kompetenciák fejlesztését szolgálja:
Knowledge
No learning outcomes recorded.
Skills
No learning outcomes recorded.
Attitudes
No learning outcomes recorded.
Autonomy and responsibility
No learning outcomes recorded.
Oktatási módszertan
2 hours (1 × 2 hours) of lecture per week.
Tanulástámogató anyagok
Online források
• Alan S. Pringle and Sarah S. O'Keefe: Technical Writing 101: A Real-World Guide to Planning and Writing Technical Content; • Edmond H. Weiss: How to Write Usable User Documentation; • JoAnn Hackos: Managing Your Documentation Projects; • Michael J. Young: XML Step by Step; • Robert Jacobson: Information Design; • William Horton: Designing and Writing Online Documentation; • Michael J. Iantosca: From microcontent to neurons; • Michael J. Iantosca: Within Reason: A survey of reasoning and inference models and techniques for generative AI solutions; • Kate L. Turabian: Manual for Writers of Research Papers, Theses, and Dissertations (Chicago Style for Students and Researchers)
Recommended preliminary knowledge for completing the subject
Knowledge type competencies
(azon előzetes ismeretek összessége, amelyek megléte nem kötelező, de a tantárgy eredményes teljesítését nagyban elősegíti)
nincs
Skill type competencies
(azon előzetes képességek és készségek összessége, amelyek megléte nem kötelező, de a tantárgy eredményes teljesítését nagyban elősegíti)
nincs
Recommended (non-compulsory) preliminary competencies
(azon ajánlott (nem kötelező) előzetesen megszerzendő kompetenciák összessége, amelyek jelentősen hozzájárulnak a tantárgy eredményes teljesítéséhez)
nincs
General rules
Requirements:
• 1 mid-term exam.
• 1 written assignment. As written assignment, the student needs to create a part of a technical documentation (i.e., instructions for a specific system or service), taking into account the considerations and approaches learned during the semester. The topics are distributed on week 4.
• The mid-term exam constitutes 40%, and the written assignment constitutes 60% of the final grade of the course.
• Both the mid-term exam and the written assignment must be passed (i.e., at least 40% of the obtainable points) in order to successfully complete the course.
Additional possibilities:
The mid-term exam can be retaken on week 15.
The deadline for the late submission of the assignment is week 15.
Assessment methods
In-term assessments
No detailed assessments provided.
Weight of in-term assessments
No weights provided.
Exam-period assessments
No detailed assessments provided.
Weight of exam elements
No weights provided.
Grade calculation
No grade thresholds provided.
Attendance requirements
No attendance requirements provided.
Rules for retake and resubmission
Not provided.
Short description
Not provided.
Detailed description
Not provided.
Recommended courses
Not provided.
Workload to complete the subject
No workload breakdown provided.
Validity of subject requirements
Requirements valid from:
—
Requirements valid until:
—
Curriculum placement
No curriculum placements recorded for this subject version.