Ellipsis docs has extra dot in the markdown that makes it look like .... (four dots)

[tirkarthi]

BPO	34817
Nosy	@vadmium, @tirkarthi
PRs	bpo-34817: Use double quote instead of backtick to clarify Ellipsis constant #9754

^{Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.}

Show more details

GitHub fields:

assignee = None
closed_at = <Date 2019-02-18.07:21:17.359>
created_at = <Date 2018-09-27.07:14:59.274>
labels = ['3.8', 'type-feature', '3.7', 'docs']
title = 'Ellipsis docs has extra dot in the markdown that makes it look like .... (four dots)'
updated_at = <Date 2019-02-18.07:21:17.359>
user = 'https://github.com/tirkarthi'

bugs.python.org fields:

activity = <Date 2019-02-18.07:21:17.359>
actor = 'xtreak'
assignee = 'docs@python'
closed = True
closed_date = <Date 2019-02-18.07:21:17.359>
closer = 'xtreak'
components = ['Documentation']
creation = <Date 2018-09-27.07:14:59.274>
creator = 'xtreak'
dependencies = []
files = []
hgrepos = []
issue_num = 34817
keywords = ['patch']
message_count = 3.0
messages = ['326529', '326631', '327324']
nosy_count = 3.0
nosy_names = ['docs@python', 'martin.panter', 'xtreak']
pr_nums = ['9754']
priority = 'normal'
resolution = 'fixed'
stage = 'resolved'
status = 'closed'
superseder = None
type = 'enhancement'
url = 'https://bugs.python.org/issue34817'
versions = ['Python 3.6', 'Python 3.7', 'Python 3.8']

[tirkarthi]

I looked up the Ellipsis documentation at https://docs.python.org/dev/library/constants.html#Ellipsis which has the below text :

The same as .... Special value used mostly in conjunction with extended slicing syntax for user-defined container data types.

The three dots are marked with backtick and look like codeblock but on a light theme it looks like a CSS issue. The backtick contains the actual ellipsis value (...) but the . at the end makes it look like .... especially since I was also using custom dark theme for https://docs.python.org so I thought it was four dots instead of three dots.

Markdown text at https://github.com/python/cpython/blob/master/Doc/library/constants.rst

The same as .... Special used mostly in conjunction with extended slicing syntax for user-defined container data types.

It's very trivial but I thought to add a report and I am fine with a won't fix for this. I thought to add a PR but English is not my first language and I don't know if it can worded better. I can change it to "The same as ... which is a special value used mostly in conjunction with extended slicing syntax for user-defined container data types." to avoid the misleading dot and feedback welcome.

Thanks

[vadmium]

In these situations, I use quotes or brackets to mention a symbol without using it as punctuation. Using words might also help. What about:

Ellipsis
The same as the ellipsis literal “...”. Special value used [etc]

[tirkarthi]

Thanks Martin for the suggestion. I have created a PR with your suggestion and added a description in the PR that shows the visual distinction between the current doc and suggested change.