Make type-hint tag

[jonathan-d-zhang]

@TizzySaurus

Closes python-discord/meta#154

Let the bikeshedding begin!

[TizzySaurus]

@SavagePastaMan

A few first-glance alterations:

I don't like that we're calling the variable sum, thus overriding the built-in sum() function. The type hint here also doesn't particularly make sense. Inline assignment type hints like this should only be done when the type isn't obvious from the variables / other type hints (the removal of the type hint arguably makes it better to just directly return rather than first assigning to a variable).

There's also some small rewording I've done here.

Current proposal:

We should probably link to some further resources on type hints (perhaps a PEP?) and also mention static type checkers like mypy which can be used to "enforce" type hints.

I'm going to bed now, will look further into this tomorrow 👍

*(Apparently my tired brain forgot to add the labels all at once so sorry for the spam there.)

[jonathan-d-zhang]

The type hint here also doesn't particularly make sense.

I wanted to include it to show that you can typehints normal variables too, maybe we can find another place to show that? I agree with not naming it sum though.

We should probably link to some further resources on type hints (perhaps a PEP?) and also mention static type checkers like mypy which can be used to "enforce" type hints.

Yes, I agree.

Also,

Both parameters and the return type of the function is said to be integers.

Should be "... function are said to ..."

@TizzySaurus

[Bluenix2]

🚴‍♂️🚴‍♂️🚴‍♂️💨💨

[TizzySaurus]

Few minor things

[onerandomusername]

Given that type-hinting also exists, it may be worth mentioning that pydis has that channel as well? Not sure.

[wookie184]

@jonathan-d-zhang are you interested in continuing this? If not i'd be happy to take over.

[jonathan-d-zhang]

@wookie184 oops, I kinda forgot about this yeah, you can take over if you'd like

[wookie184]

I've made a couple of changes, feel free to request changes on any of them if you think anything should be reverted to previous wording or changed further

[ichard26]

STGM.