mozilla / ai-guide

Mozilla AI Guide
Mozilla Public License 2.0
29 stars 21 forks source link

AI Basics: Replace scare quotes with italics #21

Open ashandoak opened 10 months ago

ashandoak commented 10 months ago

Sub-section title

WHEN I SEND A TRANSFORMER-BASED LLM A “PROMPT”, WHAT HAPPENS INTERNALLY IN MORE TECHNICAL TERMS?

Please describe your issue

Throughout this section (and possibly elsewhere) technical terms are wrapped in single quotes. For example, the following:

It uses a Transformer architecture which allows it to pay varying levels of 'attention' to different parts of the input sequence at each step of the encoding process.

Additionally, single quotes have been used to wrap example natural language phrases:

For instance, a word-level tokenizer will convert the sentence "I love coding" into 'I', 'love', 'coding'.

And in at least one instance (in section "WHY ARE PEOPLE CONCERNED ABOUT LLMS?") double quotes are actually used as scare quotes:

The tendency of users to view LLM-powered tools as “officious oracles” can lead humans to make flawed or harmful decisions based on the biases and misinformation these systems can produce.

Describe the solution you'd like to see

Technical terms should be written with an alternative typography (i.e. italics or boldface) to make clear that these aren't terms that are used loosely, but that are technical terms used in practice. For example:

It uses a Transformer architecture which allows it to pay varying levels of attention to different parts of the input sequence at each step of the encoding process.