Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

"..." is used to confusingly indicate many different things in chapter 3 #77641

Closed
lew18 mannequin opened this issue May 10, 2018 · 4 comments
Closed

"..." is used to confusingly indicate many different things in chapter 3 #77641

lew18 mannequin opened this issue May 10, 2018 · 4 comments
Labels
docs Documentation in the Doc dir type-feature A feature request or enhancement

Comments

@lew18
Copy link
Mannequin

lew18 mannequin commented May 10, 2018

BPO 33460
Nosy @gpshead, @miss-islington, @lew18
PRs
  • bpo-33460: remove ellipsis that look like continuation prompts #7851
  • [3.7] bpo-33460: remove ellipsis that look like continuation prompts (GH-7851) #9152
    		•

    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 2018-12-19.17:19:36.247>
created_at = <Date 2018-05-10.23:33:17.711>
labels = ['type-feature', 'docs']
title = '"..." is used to confusingly indicate many different things in chapter 3'
updated_at = <Date 2018-12-19.17:19:36.247>
user = 'https://github.com/lew18'

    bugs.python.org fields:

    activity = <Date 2018-12-19.17:19:36.247>
actor = 'lew18'
assignee = 'docs@python'
closed = True
closed_date = <Date 2018-12-19.17:19:36.247>
closer = 'lew18'
components = ['Documentation']
creation = <Date 2018-05-10.23:33:17.711>
creator = 'lew18'
dependencies = []
files = []
hgrepos = []
issue_num = 33460
keywords = ['patch']
message_count = 4.0
messages = ['316381', '324970', '324977', '332156']
nosy_count = 4.0
nosy_names = ['gregory.p.smith', 'docs@python', 'miss-islington', 'lew18']
pr_nums = ['7851', '9152']
priority = 'normal'
resolution = 'fixed'
stage = 'resolved'
status = 'closed'
superseder = None
type = 'enhancement'
url = 'https://bugs.python.org/issue33460'
versions = ['Python 3.6']
    @lew18
    Copy link
    Mannequin Author

    lew18 mannequin commented May 10, 2018

    https://docs.python.org/3/tutorial/introduction.html
    uses ... to mean 5 or 6 different things. Since ... is continuation prompt, some of these other uses on that page are confusing - at least they were to this newbie. The most confusing are where it is used to hide output in the error messages.

    If someone has the patience to send me pointers on how to fix this, I would love to fix this myself. -Lew

    ps. the section headers in chapter 3 also need some work, 3.1.1 is the only section that is really about python being a calculator 3.1.2 and 3.1.3 don't seem very 'calculator-y' - Id like to fix this too.

    @lew18 lew18 mannequin assigned docspython May 10, 2018
    @lew18 lew18 mannequin added docs Documentation in the Doc dir type-feature A feature request or enhancement labels May 10, 2018
    @pppery pppery mannequin changed the title ... used to indicate many different things in chapter 3, some are confusing "..." is used to confusingly indicate many different things in chapter 3 Jun 26, 2018
    @gpshead
    Copy link
    Member

    gpshead commented Sep 11, 2018

    New changeset f019579 by Gregory P. Smith (Lew Kurtz) in branch 'master':
    bpo-33460: remove ellipsis that look like continuation prompts (GH-7851)
    f019579

    @miss-islington
    Copy link
    Contributor

    New changeset 037582e by Miss Islington (bot) in branch '3.7':
    bpo-33460: remove ellipsis that look like continuation prompts (GH-7851)
    037582e

    @lew18
    Copy link
    Mannequin Author

    lew18 mannequin commented Dec 19, 2018

    Removed the ellipses from the examples, so not confused with continuation prompt. Is clearer now.

    @lew18 lew18 mannequin closed this as completed Dec 19, 2018
    @ezio-melotti ezio-melotti transferred this issue from another repository Apr 10, 2022
    Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
    Assignees
    No one assigned
    Labels
    docs Documentation in the Doc dir type-feature A feature request or enhancement
    Projects
    None yet
    Milestone
    No milestone
    Development

    No branches or pull requests
    3 participants
    @gpshead @serhiy-storchaka @miss-islington