Document test restriction in placement

Thanks! The sentence above the example should probably be updated (The function will only be available while running tests.) and the function name (test_only) should also probably be changed.

I think it would also be a good idea to document this behavior somehow. AFAIK (rustc_builtin_macros), the only attributes this affects is test and bench. I don't know how soon https://github.com/rust-lang/rust/issues/54726 might get stabilized, but if it might be a long time, maybe a brief mention at https://github.com/rust-lang/reference/blob/master/src/attributes/testing.md#the-test-attribute that says something along the lines of: "similar to proc-macros, the #[test] attribute only works as an [outer attribute], and cannot be used as an [inner attribute]".

Originally posted by @ehuss in https://github.com/rust-lang/reference/issues/906#issuecomment-732410897

Start with src/attributes/testing.md at the linked test-attribute section, then inspect the sentence above its example and locate the test_only function. Done means the documentation describes the restriction on #[test] and #[bench], and the referenced wording and function name are addressed.