diff --git a/HIG/source/img/folder.svg b/HIG/source/img/folder.svg new file mode 100644 index 0000000..22919bd --- /dev/null +++ b/HIG/source/img/folder.svg @@ -0,0 +1,21 @@ + + + + + + + + + + + + + + + + + + + + + diff --git a/HIG/source/style/writing/index.rst b/HIG/source/style/writing/index.rst index 2ebd849..4c9f10c 100644 --- a/HIG/source/style/writing/index.rst +++ b/HIG/source/style/writing/index.rst @@ -1,24 +1,26 @@ Writing ======= .. toctree:: :titlesonly: :hidden: wording capitalization contraction labels brandnames localization placeholder + vocabulary Text includes all the written, language-based elements of the interface. This includes the labels used to represent the organizational model, the names of the input and navigational controls contained for Viewing and Navigation, and the alert messages and help text used for User Assistance. * :doc:`wording` * :doc:`capitalization` * :doc:`contraction` * :doc:`labels` * :doc:`brandnames` * :doc:`localization` * :doc:`placeholder` +* :doc:`vocabulary` diff --git a/HIG/source/style/writing/vocabulary.rst b/HIG/source/style/writing/vocabulary.rst new file mode 100644 index 0000000..1a40a2b --- /dev/null +++ b/HIG/source/style/writing/vocabulary.rst @@ -0,0 +1,24 @@ +Vocabulary +========== + +Consistenly using the same words to refer to the same concepts avoids confusion. +See below word choice recommendations for common computing concepts. + +Directories and Folders +----------------------- + +.. image:: /img/folder.svg + :align: right + +For containers of files and other containers, use **folder**. Avoid *dir* or +*directory*. + +If a folder *A* contains a folder *B*: + +- *A* is the **containing folder** of *B*. Avoid *parent folder*. + +- *B* is a **subfolder** of *A*. Avoid *child folder* or *sub-folder*. + +A folder that does not have a parent folder is known as the **root folder**. +Avoid using simply *root*, except for contexts where the term is already +accompanied by a folder icon.