python / cpython

The Python programming language
https://www.python.org
Other
63.35k stars 30.33k forks source link

link to John Shipman's Tkinter 8.5 documentation fails: website no longer available #81330

Closed c6c4969e-e62c-4c58-8415-925385838127 closed 4 years ago

c6c4969e-e62c-4c58-8415-925385838127 commented 5 years ago
BPO 37149
Nosy @terryjreedy, @larryhastings, @benjaminp, @ned-deily, @roseman, @ambv, @serhiy-storchaka, @csabella, @miss-islington, @tirkarthi, @E-Paine
PRs
  • python/cpython#14616
  • python/cpython#14617
  • python/cpython#14618
  • python/cpython#14619
  • python/cpython#14620
  • python/cpython#22188
  • python/cpython#22192
  • python/cpython#22193
  • 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: ```python assignee = None closed_at = created_at = labels = ['3.8', 'expert-tkinter', '3.9', '3.10', 'docs'] title = "link to John Shipman's Tkinter 8.5 documentation fails: website no longer available" updated_at = user = 'https://bugs.python.org/xameridu' ``` bugs.python.org fields: ```python activity = actor = 'ned.deily' assignee = 'docs@python' closed = True closed_date = closer = 'ned.deily' components = ['Documentation', 'Tkinter'] creation = creator = 'xameridu' dependencies = [] files = [] hgrepos = [] issue_num = 37149 keywords = ['patch'] message_count = 25.0 messages = ['344549', '344551', '344553', '344719', '344725', '344727', '347422', '347423', '347424', '347425', '347426', '347427', '347501', '347503', '347512', '347514', '371636', '375966', '375981', '376013', '376691', '376692', '376693', '376694', '376863'] nosy_count = 13.0 nosy_names = ['terry.reedy', 'larry', 'benjamin.peterson', 'ned.deily', 'markroseman', 'docs@python', 'lukasz.langa', 'serhiy.storchaka', 'cheryl.sabella', 'miss-islington', 'xtreak', 'xameridu', 'epaine'] pr_nums = ['14616', '14617', '14618', '14619', '14620', '22188', '22192', '22193'] priority = None resolution = 'fixed' stage = 'resolved' status = 'closed' superseder = None type = None url = 'https://bugs.python.org/issue37149' versions = ['Python 3.8', 'Python 3.9', 'Python 3.10'] ```

    c6c4969e-e62c-4c58-8415-925385838127 commented 5 years ago

    On the page https://docs.python.org/3/library/tkinter.html there is a link to "Tkinter reference: a GUI for Python" which is "https://infohost.nmt.edu/tcc/help/pubs/tkinter/web/index.html".

    BIG PROBLEM : Since several days this link doesn't work any more !!!

    It's really important to fix it because most of official online documentation about tkinter was provided by this way !!!

    Fortunately i have a copy of the documentation (cf pdf file). I have downloaded this file thanks to the website above just before the link was failed ! (Yes, i know, i'm lucky...)

    Unfortunately I can't send you this pdf because I have a message "request entity too large" :-(

    tirkarthi commented 5 years ago

    A copy of the URL is present in archive.org [0] . Perhaps the docs could be updated with it.

    [0] https://web.archive.org/web/20190524140835/https://infohost.nmt.edu/tcc/help/pubs/tkinter/web/index.html

    c6c4969e-e62c-4c58-8415-925385838127 commented 5 years ago

    The comment of Karthikeyan Singaravelan seems to be a good idea.

    Question : is it possible to send a pdf (2.08 MB) to the python tracker ?

    csabella commented 5 years ago

    This reference was hosted at a university called New Mexico Tech. I've been trying to determine if this server is just offline or if it's being sunsetted. Many google search results still point to infohost.mnt.edu or redirect to that page (not just the tkinter link). Also, their main webpage (www.nmt.edu) also has a search that redirects results to infohost, so those links are all broken as well.

    It seems to me that they just haven't stood up the new site yet or else they haven't changed their redirect, so I would assume that once they find they have broken links, they will fix this. However, I also found an article that the creator of the tkinter docs has passed away [1]. If the infohost subdomain was his, then they might be moving all of it.

    Anyway, I think we should leave the docs as they are for now with the hope they the university will fix the redirect. If it doesn't get resolved, then we probably need to reach out to them. Since the author is deceased, I'm not sure how it would work to try to host it somewhere else. It would be a shame to lose this valuable reference and work.

    [1] https://www.nmt.edu/news/2019/nmt_dedicates_shipman_plaque.php

    c6c4969e-e62c-4c58-8415-925385838127 commented 5 years ago

    I have read Cheryl Sabella's comment. So I have sent this e-mail :

    Objet: Request about a broken link on your website. Date: 2019-06-05 16:20 De: xavier@guilloux-fr.net À: thomas.guengerich@nmt.edu, webmaster@nmt.edu, help@nmt.edu

    Hello,

    For several days the link "https://infohost.nmt.edu/tcc/help/pubs/tkinter/web/index.html" has stopped working. But this link provided access to a prodigious technical documentation related to a Python language module (tkinter).

    Can you put this link back in working order (or place a redirect to the new link)?

    I draw your attention to the fact that this documentation contributes significantly to the international recognition of your university.

    Thanks a lot for the continuation that you will give to this request.

    Regards.

    Xavier Guilloux.

    (following is the same message but in my natural language - French -)

    Bonjour,

    Depuis plusieurs jours le lien "https://infohost.nmt.edu/tcc/help/pubs/tkinter/web/index.html" ne fonctionne plus. Or ce lien permettait d'accéder à une prodigieuse documentation technique en rapport avec un module du langage Python (tkinter).

    Pouvez-vous remettre ce lien en état de fonctionnement (ou placer une redirection vers le nouveau lien) ?

    J'attire votre attention sur le fait que cette documentation contribue de manière importante à la reconnaissance internationale de votre université.

    Merci par avance pour la suite que vous donnerez à cette requête.

    Cordialement.

    Xavier Guilloux.

    c6c4969e-e62c-4c58-8415-925385838127 commented 5 years ago

    I have received the answer :

    Objet: Re: Request about a broken link on your website. Date: 2019-06-05 16:39 De: New Mexico Tech \help@nmt.edu\ À: xavier@guilloux-fr.net Cc: thomas.guengerich@nmt.edu, webmaster@nmt.edu

    Hello, Unfortunately infohost.nmt.edu has been shut down and we will no longer be supporting that website. The website will not be coming back up. Sorry for the inconvenience.

    -Dorothy

    ITC-UC NMIMT Socorro, NM 87801 575-835-5700

    terryjreedy commented 5 years ago

    New changeset 45bc61b97178b27ae05bd3eb95481bf0325795bb by Terry Jan Reedy in branch 'master': bpo-37149: Replace dead link for online Tkinter reference (GH-14616) https://github.com/python/cpython/commit/45bc61b97178b27ae05bd3eb95481bf0325795bb

    miss-islington commented 5 years ago

    New changeset d2c5677a4f3be7de572def0a914b96385d7982b0 by Miss Islington (bot) in branch '3.7': bpo-37149: Replace dead link for online Tkinter reference (GH-14616) https://github.com/python/cpython/commit/d2c5677a4f3be7de572def0a914b96385d7982b0

    miss-islington commented 5 years ago

    New changeset ea9c8caa13977561787bf2de430f18c2031dde0d by Miss Islington (bot) in branch '3.8': bpo-37149: Replace dead link for online Tkinter reference (GH-14616) https://github.com/python/cpython/commit/ea9c8caa13977561787bf2de430f18c2031dde0d

    terryjreedy commented 5 years ago

    Ned, PR-14616 replaces a dead link to the most important online Tkinter reference. Please consider cherry-picking the 3.7 backport (already merged) into the upcoming 3.7.4. Many people are lost without the reference, as they find reading the tcl/tk reference much harder. (The question has come up on Stackoverflow also.)

    I checked that the new link in the rebuilt revised page works.

    The longer term solution is a complete in-house doc. I have some ideas, which I will share later, for something more compact than the Shipman work (168 pages for the pdf).

    Ned, a separate question is whether the link fix or a local replacement can be backported to 3.6. It is like having half the tkinter doc, the part covering tk widgets, removed.

    terryjreedy commented 5 years ago

    The 2.7 backport shows a clean 2.7 diff, Travis merged and passed it, but required Appveyor just says 'non-mergeable' with no details, and no way to discover why or to cleanly retry. I will try close and open once.

    miss-islington commented 5 years ago

    New changeset 55270d09c212654c4f1bc9ebf9a0081c169a6d12 by Miss Islington (bot) in branch '2.7': bpo-37149: Replace dead link for online Tkinter reference (GH-14616) https://github.com/python/cpython/commit/55270d09c212654c4f1bc9ebf9a0081c169a6d12

    ned-deily commented 5 years ago

    New changeset 317c33e67cb6076c5a87a66c75e8c35ac581398d by Ned Deily in branch '3.6': bpo-37149: Replace dead link for online Tkinter reference (GH-14616) https://github.com/python/cpython/commit/317c33e67cb6076c5a87a66c75e8c35ac581398d

    terryjreedy commented 5 years ago

    Larry, I have the same request of you that I did for Ned. Please backport PR-14616 to 3.5. It replaces a dead link to the most important online Tkinter reference. Many people are lost without the reference, as they find reading the tcl/tk reference much harder. It is like having half the tkinter doc, the part covering tk widgets, removed. (The question has come up on Stackoverflow also.) The replacement will benefit any 3.5 users looking at the online 3.5 docs.

    ned-deily commented 5 years ago

    New changeset f2cbf41afc9e9a0ce16bfe0c71662348453a28c4 by Ned Deily (Miss Islington (bot)) in branch '3.7': bpo-37149: Replace dead link for online Tkinter reference (GH-14616) https://github.com/python/cpython/commit/f2cbf41afc9e9a0ce16bfe0c71662348453a28c4

    ned-deily commented 5 years ago

    A few comments on this. One, the Tkinter documentation in question seems to have been a personal project of John Shipman at New Mexico Tech and, as such, was not "official" so I've updated the issue title accordingly. Sadly, as Cheryl noted, John died two years ago and I guess there were no plans in place for someone to take the documentation over from him. We can all appreciate his very valuable contributions over the years by developing and maintaining this additional documentation. It would be great to find a way to provide an equivalent resource for Tk 8.6. The best alternatives today is probably Mark Roseman's TkDocs website and "Modern Tkinter" book/ebook, both also already linked on our Standard Library tkinter page. I've nosied Mark in case he has any thoughts on the matter.

    As far as updating the page in older releases, as 3.6 release manager I did decide to allow the update there, even though we normally would not make such a change for a security-fix-only release; I did so as we are still including 3.6 in our daily doc builds on docs.python.org (although at some point soon that will stop). It's Larry's call about 3.5 but note that the current 3.5 docs on docs.python.org are normally only updated when a new 3.5.x security-fix release appears. If you want it to be considered for 3.5, it would be best to make a 3.5 backport PR.

    919475b3-36a2-4cd7-997c-9c38f05f93c7 commented 4 years ago

    I know I'm a bit late, but I believe the site is now being hosted on a Gtihub page: https://anzeljg.github.io/rin2/book2/2405/docs/tkinter/index.html

    I suspect this is another personal project just for historical reference and will not be updated, however I would (personally) prefer not to be linked to the Wayback Machine.

    f4315b71-14d3-4c16-bb7a-6534e5fa1d04 commented 4 years ago

    Hello, also (very) late to this party.

    If this would be useful, and unless anyone has any objections, I'd be open to hosting a copy of John's material on tkdocs.com. I'd add a header to each page explaining it's an unmaintained archive with all the usual caveats.

    That would at least provide a stable place to link to.

    terryjreedy commented 4 years ago

    Pending improving the our docs, I would like to replace the Archive link, which is slow to respond. Issue: there is no copyright notice. Once might expect it to belong to NMT, but they seem to have disowned it by removing the web pages. The dead links should be removed from any copy. The .pdf line in the does work at this moment.

    If not a work-for-hire, the copyright belonged to Shipman, and now his estate. I would not add it to the PSF site without formal permission, but I don't see why linking to one unauthorized copy versus another would make much difference.

    f4315b71-14d3-4c16-bb7a-6534e5fa1d04 commented 4 years ago

    I've posted a copy at https://tkdocs.com/shipman/

    I've lightly modified it to add a site header and explanation of where the material comes from and caveats about age to each page, and have removed or crossed out dead links, requests for feedback, etc.

    I agree with Terry's assessment of the copyright issues. While I don't expect anyone with a valid claim to contact me about the mirrored copy, I'd be happy to address any concerns if they do arise.

    If this all seems okay, I would very greatly appreciate if someone could update the links in the Python documentation for all the relevant branches and shepherd that through the approval process.

    terryjreedy commented 4 years ago

    New changeset 06d0b8b67e8aebd8fe4c34e97d6915c11f4afa30 by Mark Roseman in branch 'master': bpo-37149: Change Shipman tkinter link from archive.org to TkDocs (GH-22188) https://github.com/python/cpython/commit/06d0b8b67e8aebd8fe4c34e97d6915c11f4afa30

    miss-islington commented 4 years ago

    New changeset 1b4bdb4cd71df6339da3f247516e0c642f40c37e by Miss Islington (bot) in branch '3.9': bpo-37149: Change Shipman tkinter link from archive.org to TkDocs (GH-22188) https://github.com/python/cpython/commit/1b4bdb4cd71df6339da3f247516e0c642f40c37e

    terryjreedy commented 4 years ago

    New changeset 8a30bdd21dff6d1957df135c9d0b9983a0f61228 by Miss Islington (bot) in branch '3.8': bpo-37149: Change Shipman tkinter link from archive.org to TkDocs (GH-22188) (bpo-22193) https://github.com/python/cpython/commit/8a30bdd21dff6d1957df135c9d0b9983a0f61228

    terryjreedy commented 4 years ago

    The tkdocs pages load in less than a second rather than in several seconds, have the obsolete link lined out, and include a short explanatory note. So I made the replacement.

    Ned, please backport to 3.7 and 3.6 if still built nightly.

    ned-deily commented 4 years ago

    In general, we do not backport documentation changes to branches in the security-fix phase of their life cycles and their online versions are only updated for a release.