"

Writing the Definitions

This page provides tips and steps to help you write the definitions for your Wiki Project.

What to Do

1️⃣Break it down: Identify what your thing is and what category of thing it belongs to. A good definition starts with listing your things among related things before you explain how they differ.

For example, a Pixel 8 is a top-line smartphone within the Google Pixel brand. In that example, we set up the Pixel 8 as the thing being defined and that it is a type of smartphone. After this, we can expand on the features and components that define the Pixel 8 from other smartphones.

2️⃣Focus on function: Explain what the concept does and how it works, using clear and concise language. Avoid jargon and overly technical terms. Think of it as giving the “big picture” understanding.

3️⃣Connect it: Relate the concept to something familiar or provide a real-world example to help solidify understanding. This helps bridge the gap between the technical and the everyday. Drawing appropriate connections for the audience level is an easy way to write an expanded and more detailed technical definition.

Technical definitions are concise explanations of technical terms or concepts. They are vital in any technical document as they clarify and prevent misinterpretation. A well-written technical definition allows users, whether software engineers or end-users, to fully understand the topic.

When creating technical definitions, paying attention to several important details is vital.

Ensure that your definitions are precise and concise. You should avoid using unnecessary words or information that could confuse your audience. It is also essential to provide clear and accurate explanations of any technical terms you use so your audience can understand them.

Avoid using jargon as much as possible. If you must use it, define any technical terms or acronyms you use so your audience can follow along. Jargon can be a barrier to understanding, especially for people unfamiliar with the technical language.

Remember that your purpose is to make complex concepts understandable, not to showcase your technical vocabulary. Your audience should be able to understand your definitions without feeling overwhelmed or confused.

By following these guidelines, you can create technical definitions that are clear, concise, and easy to understand.

AI Prompting

The AI interns are very good at this task. You should write these on your own so that YOU know the structure of a definition.

So… don’t use the intern this time.

Here is an example of a definition created by my Gemini Intern. Take time to analyze the aspects of the definition and use it as a model to create your own (again, you should learn the structure and how to do something yourself before handing it off to the intern completely). You should identify the three-part structure, components, and functions that all contribute to a detailed description and definition of the topic.

Prompt to Gemini: write an extended definition at a technical level for a Logitech wireless mouse

1. Overview: A Logitech wireless mouse is an input device designed for interacting with computers and other digital devices. It utilizes wireless technology (e.g., Bluetooth, RF) to transmit user input signals to the connected device, eliminating the need for a physical cable.

2. Key Components:

  • Sensor: Tracks movement on a surface, converting it into digital signals. Technologies include optical (LED) and laser, with varying levels of accuracy and resolution (DPI).
  • Microprocessor: Processes sensor data and transmits it wirelessly to the connected device.
  • Wireless Module: Transmits and receives data using Bluetooth, RF, or proprietary Logitech protocols.
  • Buttons: Typically, left and right click, scroll wheel, and additional programmable buttons depending on the model.
  • Battery: Powers the mouse, with options like rechargeable batteries or replaceable AA/AAA batteries.
  • Housing: Ergonomic design for user comfort and grip, made of plastic or other materials.

3. Functionality:

  • Movement Tracking: The sensor detects movement and translates it into cursor movement on the screen.
  • Button Presses: Registering clicks and other button presses for various computer functions like selection, navigation, and application commands.
  • Scrolling: Facilitates vertical and horizontal scrolling through documents and web pages.
  • Wireless Connectivity: Eliminates cable clutter and provides flexibility in usage location.
  • Power Management: Optimizes battery life through features like automatic sleep mode.

4. Technical Specifications:

  • Sensor Resolution (DPI): Measures the sensitivity of the sensor, indicating how much movement translates to cursor displacement on the screen. Higher DPI is generally preferred for precise movements and gaming.
  • Wireless Range: Varies depending on technology and model, typically ranging from 3-10 meters.
  • Battery Life: Can vary significantly based on usage, battery type, and power-saving features.
  • Connectivity Protocol: Bluetooth, RF, or proprietary Logitech protocols.
  • Additional Features: May include programmable buttons, gesture recognition, customizable lighting, and ergonomic design features.

5. Applications:

  • General computer usage: Navigation, selection, scrolling, and interacting with applications.
  • Gaming: Precise aiming and movement control in games.
  • Portable computing: Wireless convenience for laptops and tablets.
  • Design and creative work: Scrolling through large documents and images.

Note: This definition is a general overview and may not encompass all features or variations present in specific Logitech wireless mouse models.

License

Icon for the Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License

Technical Writing and Presentation Copyright © 2024 by Hayley Blackburn is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License, except where otherwise noted.