[issue41411] Improve and consolidate f-strings docs

Raymond Hettinger added the comment: Eric, do you want to approve and apply these PRs ? -- assignee: docs@python -> eric.smith nosy: +rhettinger ___ Python tracker ___ ___

[issue41411] Improve and consolidate f-strings docs

Stéphane Blondon added the comment: It seems ezio-melotti hesitates to continue the modifications in the PR https://github.com/python/cpython/pull/21552#pullrequestreview-458400056 IMO, the PR improves enough the documentation, so it would be nice to merge it, even without the other changes.

[issue41411] Improve and consolidate f-strings docs

Guido van Rossum added the comment: @ezio.melotti: What is this waiting for at this point? There was some good energy here but progress seems halted, waiting for some kind of decision. -- ___ Python tracker ___

[issue41411] Improve and consolidate f-strings docs

Ama Aje My Fren added the comment: Hi, >The online docs seem updated, so I'm not sure why it's not working. Maybe you >could try So it seems that the .. index::[0] directive creates an index[1]. Both f-index and findex are available in it. Search is a bit different. A searchindex[2] is gene

[issue41411] Improve and consolidate f-strings docs

Ezio Melotti added the comment: Thanks both for pointing out the additional section in inputoutput.rst that I initially missed. > I have done PR 21681 that adds index to the tutorial although searching[2][3] > does not seem to be better now that the reference has an index. The online docs s

[issue41411] Improve and consolidate f-strings docs

Ama Aje My Fren added the comment: Hi, Thanks Ezio for the detailed response. > In the list of proposed solutions in my first message, 1-3 should be quite > easy to implement. This leaves us with 4-5. To the best of my seeing there are only two places in the documentation that have inform

[issue41411] Improve and consolidate f-strings docs

Change by Ama Aje My Fren : -- pull_requests: +20825 pull_request: https://github.com/python/cpython/pull/21681 ___ Python tracker ___ _

[issue41411] Improve and consolidate f-strings docs

Guido van Rossum added the comment: Note that there already is something in the tutorial about f-strings (in inputoutput.rst, labeled tut-f-strings), and the intro has a link to their reference manual description in the "see also" section. -- ___ Py

[issue41411] Improve and consolidate f-strings docs

Ezio Melotti added the comment: HOWTOs are generally used to explain how to accomplish a certain task, so I'm not sure if they are a good fit for this situation. In the list of proposed solutions in my first message, 1-3 should be quite easy to implement. This leaves us with 4-5. To summari

[issue41411] Improve and consolidate f-strings docs

Ama Aje My Fren added the comment: Hi Ezio, Would you see this being resolved in part by a HOWTO document? -- nosy: +amaajemyfren ___ Python tracker ___ _

[issue41411] Improve and consolidate f-strings docs

Change by Ezio Melotti : -- keywords: +patch pull_requests: +20788 stage: needs patch -> patch review pull_request: https://github.com/python/cpython/pull/21552 ___ Python tracker

[issue41411] Improve and consolidate f-strings docs

Guido van Rossum added the comment: It's basically an accident that the only f-strings docs are in the language reference. Yes, they should be there, and the text there is pretty good *for the reference*, but there isn't much about them elsewhere outside of the tutorial, so everything links

[issue41411] Improve and consolidate f-strings docs

Eric V. Smith added the comment: I think this is an excellent idea. The main f-string docs being in a section titled "Lexical Analysis" never seemed very user-friendly. -- ___ Python tracker ___

[issue41411] Improve and consolidate f-strings docs

New submission from Ezio Melotti : [Creating a new issue from #41045] I was just just trying to link to someone the documentation for f-strings, but: 1) Searching "fstring" only returns two results about xdrlib[0]; 2) Searching "f-string" returns many unrelated results[1]; 3) The first (and clos