[issue21956] Doc files deleted from repo are not deleted from docs.python.org.

[Julien Palard]

Julien Palard  added the comment:

This is resolved since https://github.com/python/docsbuild-scripts/pull/28.

It could still happen in very specific conditions, but not for a long time, see:

https://github.com/python/docs-community/issues/41#issuecomment-1088462199=

--
nosy: +mdk
resolution:  -> fixed
stage:  -> resolved
status: open -> closed

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue21956] Doc files deleted from repo are not deleted from docs.python.org.

[Mark Lawrence]

Change by Mark Lawrence :


--
nosy:  -BreamoreBoy

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue21956] Doc files deleted from repo are not deleted from docs.python.org.

[Brandon Rhodes]

Brandon Rhodes added the comment:

Now that I am back at a full keyboard, I see that my previous response
to @BreamoreBoy about this issue is too short and too cryptic to really
serve as a fair answer to his question.  And, with some embarrassment, I
note that my words did not even achieve the dignity of forming an actual
English sentence.  Alas for cramped travel laptop keyboards and airport
wi-fi!

Might I be allowed another try?  If so, then: @BreamoreBoy, I think that
your confusion (How does that translate?) can be blamed squarely on
the document in question.  Instead of introducing and maintaining a
consistent terminology, it manages to burden the reader with two
parallel and redundant sets of terms for exactly the same idea.

In short, the document title does not match the document itself.

The title of the document sets forth the terms Idiom and Anti-idiom
as its subject.  But then it completely drops the ball.  The terms are
not defined in the document itself.  They are not clarified anywhere in
its text.  Nor are they even *used* anywhere in its body, with a single
lonely exception buried down somewhere around the middle (second
paragraph under Exceptions).

Instead, the body uses the simpler phrases Do, do not, and should
not.  It is running in its do not / don't mode when it reaches the
sentence you quote, Mark, about from...import statements.

So the answer to your How does that translate question is that what
the title promises as Idioms and Anti-idioms actually come out
verbally in the text as do and don't instead.  When someone jumps
into the middle of the document without context, they see only do or
don't and are left wondering where the terminology of idioms is even
coming from.  But it comes directly from the title, as the only possible
mapping between the document's terms and those of its title.

So when the document says:

from module import name1, name2. - This is a don’t...

the careful reader who has noticed and remembered the title will
simultaneously read:

from module import name1, name2. - This is an anti-idiom...

Which is almost exactly the text of Audrey's tweet.

--

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue21956
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue21956] Doc files deleted from repo are not deleted from docs.python.org.

[R. David Murray]

R. David Murray added the comment:

The file no longer exists in the 3.5 tree on the server.  Since it isn't linked 
from the 3.4 index, it may be more effort than it is worth to get someone to 
delete the file from the 3.4 tree on the server.  On the other hand, fixing the 
publication process to delete files is something the doc team should probably 
tackle (note: it might be a sphinx issue, but as Brandon says is more likely an 
issue with the script that publishes the pages to the server).

As for revising the howto and re-adding it, that is a separate issue and should 
be discussed on the original issue 7391, where the possibility was already 
raised and got some support.

--
nosy: +r.david.murray
title: Deleted document should not appear in 3.4 docs - Doc files deleted from 
repo are not deleted from docs.python.org.
versions: +Python 2.7, Python 3.5

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue21956
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue21956] Doc files deleted from repo are not deleted from docs.python.org.

[Audrey Roy]

Audrey Roy added the comment:

 Since it isn't linked from the 3.4 index, it may be more effort than 
 it is worth to get someone to delete the file from the 3.4 tree on the
 server.

It would be worthwhile to delete or fix it in the 2.7 and 3.4 tree.

It accidentally gets linked, still causing confusion to 2.7 and 3.4 users:
https://twitter.com/audreyr/status/487446878837944320

--
nosy: +audreyr

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue21956
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue21956] Doc files deleted from repo are not deleted from docs.python.org.

[Mark Lawrence]

Mark Lawrence added the comment:

The docs state 'from module import name1, name2. - This is a “don’t” which is 
much weaker than the previous “don’t”s but is still something you should not do 
if you don’t have good reasons to do that.'  How does that translate into 'The 
Python docs say that from module import name1, name2 is an anti-idiom' ?

--
nosy: +BreamoreBoy

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue21956
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue21956] Doc files deleted from repo are not deleted from docs.python.org.

[Brandon Rhodes]

Brandon Rhodes added the comment:

I do not find it unreasonable, on a page of Python idioms, the we would call an 
example that explicitly says Don't in its title an anti-idiom.

--

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue21956
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue21956] Doc files deleted from repo are not deleted from docs.python.org.

[Audrey Roy]

Audrey Roy added the comment:

Mark, I and a number of others simply misinterpreted the text in that section.

--

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue21956
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com