Espressif Manual of Style Quiz

Welcome to the Espressif Manual of Style Quiz! The quiz is still a work in progress, and we are currently finalizing the questions and answers.

Numbers

1. The development board operates at a power supply.

5V
five V
5 V

Hint:
1. Use Arabic numerals (5, not five) for measurements.
2. Use a space between the number (5) and measurement unit (V).

3. Which of the following numerical expressions are incorrect?

ESP8266 has seventeen GPIO pins.
ESP32 has 3 UART controllers.
Set the duty cycle to 90%.

Hint:
1. Use Arabic numerals (17) for 10 and greater whole numbers.
2. Spell out single-digit whole numbers.

3. Which of the following numerical expressions are correct?

10240 bits
page 10240
10,000 B.C.

Hint:
1. Use a comma “,” to mark off groups of three digits for numbers of five digits or more.
2. Do not use commas in page numbers, addresses, and decimal fractions.

4. Fix the mistakes(s) in the sentence:

80 to 240 MHz of frequency is available for the CPU clock.

Eighty to 240 MHz of frequency is available for the CPU clock.

Hint: Avoid starting a sentence with a number. A clearer way to phrase this is: The CPU clock frequency is adjustable from 80 MHz to 240 MHz.

Submit Reset

Editing References

1. Which of the following is incorrect usage of references?

See ESP32 Datasheet > Chapter Overview.
Please visit www.espressif.com.
For information about .., refer to this document.

Hint: For online references that are formatted as hyperlinks, use descriptive text for the hyperlink; do not use blank expressions, such as “this document”.

2. For Chinese titles of books, articles, newspapers, songs, films, which of the following punctuation marks should be used?

Double quotation marks (“…”)
Book title marks (《…》)
No punctuation marks should be used

Hint: Use book title marks (《…》) for Chinese titles of books, articles, newspapers, songs, films, etc.

3. Improve the sentence:

For the pin layout of ESP32, please see Section Pin Layout > Chapter Pin Definitions > ESP32 Datasheet.

For the pin layout of ESP32, please see ESP32 Datasheet > Chapter Pin Definitions > Section Pin Layout.

Hint: Structure the references from the most general to the most specific reference..

Submit Reset

UI Elements

1. Which is the correct way to describe interaction with the following UI element in .rst or .md documents?

Toggle View Nested.
Toggle the View nested button.
Toggle View nested.

Hint:
1. Write out the UI element text exactly as it appears in the interface, including the capitalization.
2. Enclose UI element text in double backquotes (``) in .rst document and single backquotes (`) in .md documents, which will generate in-line code blocks.

2. Which is the correct way to indicate navigation through UI elements?

Go to CloudFormation in Services in the AWS Console.
Go to AWS Console -> Services -> CloudFormation.
Go to AWS Console > Services > CloudFormation.

Hint:
1. Use a greater-than symbol (>) to indicate a sequence of UI navigation steps.
2. Follow the actual order users interact with the interface.

3. Which is the correct way to describe the interaction with the following UI element in .rst or .md documents?

Click on Set Email Template.
Click at the Set Email Template button.
Click Set Email Template.

Hint: Use "Click" alone without adding "on" or "at" when describing the press-and-release action.

Submit Reset

Provide feedback about this document