yield_fixture docs need updating

[pytestbot]

Originally reported by: Brianna Laugher (BitBucket: pfctdayelise, GitHub: pfctdayelise)

---

http://pytest.org/latest/yieldfixture.html says

“yielding” fixture values is an experimental feature and its exact declaration may change later but earliest in a 2.5 release. You can thus safely use this feature in the 2.4 series but may need to adapt later.

I think it is not actually the case that it is still experimental - it can cause confusion about if this feature should be used or not.

I am not sure what exactly the official status of it is now, so perhaps someone else can suggest what the wording should be.

---

• Bitbucket: https://bitbucket.org/pytest-dev/pytest/issue/690

[pytestbot]

Original comment by holger krekel (BitBucket: hpk42, GitHub: hpk42):

---

I guess you are right and we can strike the wording. If we change it now we need to think about backward-compatibility because it is in relatively wide use, independently from the warning. Feel free to do a PR.

[pytestbot]

Original comment by Brianna Laugher (BitBucket: pfctdayelise, GitHub: pfctdayelise):

---

Fixed by @nicoddemus in https://bitbucket.org/pytest-dev/pytest/pull-request/267/removed-note-about-yield-fixtures-being/commits