Skip to content

Commit 6492007

Browse files
committed
Improve glossary entries
1 parent dadc1f3 commit 6492007

File tree

1 file changed

+11
-5
lines changed

1 file changed

+11
-5
lines changed

Doc/glossary.rst

Lines changed: 11 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -724,8 +724,13 @@ Glossary
724724
:term:`finder` and :term:`loader` object.
725725

726726
index
727-
A numeric value that represents the position of an entry in
727+
A numeric value that represents the position of an element in
728728
a :term:`sequence`.
729+
730+
In Python, indexing starts at zero.
731+
For example, ``things[0]`` names the *first* element of ``things``;
732+
``things[1]`` names the second one.
733+
729734
In some contexts, Python allows negative indexes for counting from the
730735
end of a sequence, and indexing using :term:`slices <slice>`.
731736

@@ -1354,10 +1359,11 @@ Glossary
13541359

13551360
subscript
13561361
The expression in square brackets of a
1357-
:ref:`subscription expression <subscriptions>`, usually used to select
1358-
an element of a container.
1359-
Also called a :term:`key` when subscipting a :term:`mapping`,
1360-
or :term:`index` when subscipting a :term:`sequence`.
1362+
:ref:`subscription expression <subscriptions>`, for example,
1363+
the ``3`` in ``items[3]``.
1364+
Usually used to select an element of a container.
1365+
Also called a :term:`key` when subscripting a :term:`mapping`,
1366+
or :term:`index` when subscripting a :term:`sequence`.
13611367

13621368
t-string
13631369
t-strings

0 commit comments

Comments
 (0)