background preloader

Plain English Campaign

Plain English Campaign

0.2 — Introduction to programming languages Todays computers are incredibly fast, and getting faster all the time. Yet with this speed comes some significant constraints. Computers only natively understand a very limited set of instructions, and must be told exactly what to do. The set of instructions that tells a computer what to do is known as software. A computer’s CPU is incapable of speaking C++. For example, here is a x86 machine language instruction: 10110000 01100001 Second, each set of binary digits is translated by the CPU into an instruction that tells it to do a very specific job, such as compare these two numbers, or put this number in that memory location. Because machine language is so hard to program with, assembly language was invented. Here is the same instruction as above in assembly language: mov al, 061h To address these concerns, high-level programming languages were developed. A compiler is a program that reads code and produces a stand-alone executable that the CPU can understand directly.

20 Rules for Writing So Crystal Clear Even Your Dumbest Relative Will Understand Has this ever happened to you? You’re driving to work. Or reading a book. Or just drifting off to sleep. And it comes out of nowhere like a thunderbolt. The perfect idea for your blog. So you excitedly scribble it down, write it up and get it out into the world via your blog. And then… Nothing. No reaction. Just the sound of digital tumbleweeds blowing across the virtual savannah. You don’t understand what went wrong. Is it possible your idea simply wasn’t as ground-breaking as you first thought? Sure, it’s possible. Your writing simply isn’t clear enough. Why Spreading Your Ideas is Like Trying to Assemble an IKEA Table Have you ever tried to assemble flat pack furniture without the instruction manual? It’s practically impossible, right? Even with the instructions it’s hard enough. And when you’re done, it always seems like there’s a piece missing – or a piece left over – and the end product looks like it could fall apart at any minute. It’s exactly the same with your ideas. X who Y. A bonus step.

Interacting with People with Disabilities | The Basics | Just Ask: Integrating Accessibility Throughout Design Some people are uncomfortable talking with people with disabilities. This chapter gives you some basic tips to help you be more comfortable interacting with people with disabilities, and to help people with disabilities more enjoy interacting with you. First, let's look at the reasons that some people are uncomfortable with people with disabilities. One reason is that some people feel sorry for people with disabilities, and assume that they are bitter about their disabilities. This is untrue in many cases. In an interview on Larry King Live, some people said of their disabilities: I wouldn't change it. Another reason that some people are uncomfortable around people with disabilities is that they're afraid that they will "say the wrong thing". In the movie "I am Sam", the main character, Sam, is an adult with a developmental disability. One basic question many people have is: What is appropriate terminology, for example, disability, impairment, or handicap? Ask before you help.

Over 200 words to use instead of said This is page is updated often. Be sure to refresh the page by pressing both the Ctrl key and the F5 key to ensure you are seeing the latest version. Looking for a specific word? Press the Ctrl key and the F key to open up a search box. For instructions on how to properly use the words below, click the instructions button below: 👨🏼‍🏫 Instructions The words below are classified by category The words below are classified by emotions Do you have a word that you think should be added to this list, or a comment? 📬 E-mail To those of you who have e-mailed suggestions to me, I would like to say thank you very much. To view the alphebetized list of examples of words to use instead of said, touch the button below to go the examples page. 🦉 Examples To print the list above click the button below to download the PDF file.It takes twenty-three (23) 8.5" x 11" pages to print the list, so you may want to consider double-sided printing. 🖨️ Print 🖨️ Print

open-guides/og-aws: □ Amazon Web Services — a practical guide How to Write a Technical Book Table of Contents 1. Rethink Your Idea Writing a book is really, really, really hard. It sounds like a great idea at first, something you may have dreamed about for years, but it's a heck of a lot of work in practice. 2. The easiest way to get published is to already have been published, a typical Catch-22 situation. 2.1 Publishing Before You Publish To gain writing experience you can publish to the web, in local newspapers, in print magazines, or within corporate newsletters. 2.2 Selecting a Publisher The next step is to select a publisher, and to do that you need to identify which ones exist within the book category which you'll be writing in. Having identified potential publishers contact them and ask for their proposal guidelines. Identifying the potential market for your book is critical. You can usually submit the same proposal to several publishers, but remember that it's a small industry and be judicial about who you send it to. 2.3 Planning the Book 2.4 Negotiating the Contract 3.

George Orwell on writing: Johnson: Those six little rules IN MY last column, I referred to The Economist’s style guide, which includes George Orwell’s famous six rules for writing, taken from “Politics and the English Language”: (i) Never use a metaphor, simile, or other figure of speech which you are used to seeing in print.(ii) Never use a long word where a short one will do.(iii) If it is possible to cut a word out, always cut it out.(iv) Never use the passive where you can use the active.(v) Never use a foreign phrase, a scientific word, or a jargon word if you can think of an everyday English equivalent. Around the same time, my colleague flagged a candidate for “The world's worst sentence”. Yet the nightmare cast its shroud in the guise of a contagion of a deer-in-the-headlights paralysis. My colleague, too, referred to Orwell’s rules, suggesting that bad writing of this (and other) kinds could be avoided by following them. The problem is the absolute nature of Orwell’s rules. So Orwell exposes himself right there in paragraph two.

Guide to Technical Report Writing : Study guides : ... : School of Engineering and Informatics : Schools and services Download pdf version for print Table of contents 1 Introduction 2 Structure 3 Presentation 4 Planning the report 5 Writing the first draft 6 Revising the first draft 7 Diagrams, graphs, tables and mathematics 8 The report layout 9 Headings 10 References to diagrams, graphs, tables and equations 11 Originality and plagiarism 12 Finalising the report and proofreading 13 The Summary 14 Proofreading 15 Word processing / desktop publishing 16 Recommended reading 1 Introduction A technical report is a formal report designed to convey technical information in a clear and easily accessible format. 2 Structure A technical report should contain the following sections; 3 Presentation For technical reports required as part of an assessment, the following presentation guidelines are recommended; 4 Planning the report There are some excellent textbooks contain advice about the writing process and how to begin (see Section 16). Collect your information. 5 Writing the first draft Who is going to read the report? 9 Headings

Rules at Grammar Bytes! Terms of Use You may not alter, sell, or post these materials on a different server. Photocopying for students or linking to materials here does not require my permission. Home • Terms • Exercises • MOOC • Handouts • Presentations • Videos • Rules • About • Shop • Feedback ©1997 - 2016 by Robin L. valid html

10 Examples of Great End User Documentation In a previous article, I went over 14 examples of documentation mistakes you might be making. Today, I'm going to show you 10 examples of what makes great end user documentation. I should clarify that end user documentation does not serve the same purpose as technical documentation, so you shouldn't write them the same way. The examples I show are examples of what makes great end user documentation. 1 - Write great titles Great end user documentation consists of titles that are specific, and often in the form of performing a task. For example, think about how much time it would take to write an article titled "Contacts" - you wouldn't know where to start. If each article has its own, great title, then your end users can quickly answer their own questions by performing a keyword search or by browsing through your table of contents. HubSpot does a great job writing useful titles, and then demonstrating the workflow using pictures, text, and annotations. Tip for writing great titles

Related: