search

python-discord / meta

Issue tracker for suggestions and other questions relating to our community
https://pythondiscord.com
31 stars 5 forks source link

Improve the `in-place` tag #213

Closed n0Oo0Oo0b closed 10 months ago

n0Oo0Oo0b commented 1 year ago

Amendment type

Content Update

Content type

Tag

Please provide the location of the content

in-place

What amendment do you think should be made to this content, and why?

The current in-place tag only has an example of wrong uses of in-place/out-of-place functions and only describes correct usage, which can confuse beginners who don't read the comments and assume that it is the correct way of using them. The tag should at least include the correct usage (and maybe get rid of the incorrect usage).

There are also minor errors in the rest of the tag which should be fixed, such as brackets being inside of inline code formatting:

... either use an out-of-place operation (sorted(...)) and assign it to a variable ...

wookie184 commented 10 months ago

Both suggestions sound good to me, and yeah could probably get rid of the incorrect usage as long as it's made clear why the correct usage is correct.