Budapest University of Technology and Economics, Faculty of Electrical Engineering and Informatics

    Belépés
    címtáras azonosítással
    vissza a tantárgylistához   nyomtatható verzió    

    Technical Communication in Industry and Academia

    A tantárgy neve magyarul / Name of the subject in Hungarian: Műszaki kommunikáció az iparban és a tudományos életben

    Last updated: 2026. február 3.

    Budapest University of Technology and Economics
    Faculty of Electrical Engineering and Informatics     		Electrical Engineering
    Computer Engineering
    Free electives
    Course ID Semester Assessment Credit Tantárgyfélév
    VIHIAV51   2/0/0/f 2  
    3. Course coordinator and department Dr. Kara Péter András,
    4. Instructors Dr. Kara Péter András      assistant professor      HIT
    7. Objectives, learning outcomes and obtained knowledge 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.
    8. Synopsis 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?
    9. Method of instruction 2 hours (1 × 2 hours) of lecture per week.
    10. Assessment •    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.

    11. Recaps The mid-term exam can be retaken on week 15.
    The deadline for the late submission of the assignment is week 15. 
    12. Consultations Any time during the semester, based on demand.
    13. References, textbooks and resources •    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)

    14. Required learning hours and assignment
    Lectures (1x2 hours for 14 weeks)
    		28
    Preparation for lectures
    		8
    Preparation for the mid-term exam
    		8
    Preparation of the written assignment
    		16
    Total60
    15. Syllabus prepared by Dr. Kara Péter András      assistant professor      HIT