add more docs on the fspath deprecation

[RonnyPfannschmidt]

provide more help for testing and general code handling it

Originally posted by @RonnyPfannschmidt in #8418 (reply in thread)

[h-vetinari]

Since #8037 has gone in, this should probably be remilestoned to 7.0? CC @The-Compiler

PS. The GH UI looks mighty confusing with renamed milestones:

[nicoddemus]

Fixed, thanks!

[nicoddemus]

Ahh no sorry, it should be removed from 7.0 but will be released in a future version.

[h-vetinari]

Ahh no sorry, it should be removed from 7.0 but will be released in a future version.

How so? It's already released, isn't it (based on the notice you link below)? Quoting from #8418 (which is what this issues was about):

hl037: From here: https://docs.pytest.org/en/latest/reference.html#request [fixed link]
I can see request.fspath will be deprecated. I can't find information about this decision and I was wondering what could I use instead to get the current test path ?

@RonnyPfannschmidt: Good catch, the path alias needs to be added there, request.node.path will do meanwhile

@nicoddemus: we have a short notice here: https://docs.pytest.org/en/latest/deprecations.html#node-fspath-in-favor-of-pathlib-and-node-path

However I wonder if we should expand that? We only mention some kind of reasoning briefly:

As pytest tries to move off py.path.local we ported most of the node internals to pathlib.

Should we expand/create a new section with the rationale and future plans?

@RonnyPfannschmidt: We should

[The-Compiler]

Yeah, it sounds like this should be in 7.0. The fspath deprecation is in 7.0, so I suppose we should also have proper deprecation docs there. Let's add it for now and then look at it in detail later before the final release.