[Feature] Comment doc block

[Mte90]

So right now we have tons of function in stdlib.

Can be handy to document them in the file itself, in this way the documentation can generated aautomatically.
So I was thinking something for that.

In Amber looking at the doc there is no way right now for commenting, so we need to choose what is the best way.

Rust uses /** like PHP (https://doc.rust-lang.org/reference/comments.html), python instead use """the sentence""".

[b1ek]

i think we should use /// and /** */ for doc strings to be consistent with rust

also we should think through tags like this:

/**
    @return It will return none if has failed
*/
async fn get_user() -> Option<User> { ... }

[b1ek]

id say we go with these:

tag	desc
@return {desc}	is used to describe a function's return value
@param {paramName} {desc}	is used to describe a function's param
@author {name}	is used to describe the author
@license {SPDXID}	to describe the license

[Mte90]

Seems the best way, maybe with https://docs.rs/comment-parser/latest/comment_parser/ we can implement easily?

[Ph0enixKM]

At #62 I used /// syntax for doc comments. We could use the @param etc. just like in JSDoc to document particular params and the return type. Not sure if @author and @license are necessary at this stage but yeah

[Mte90]

So we want follow the jsdoc standard or one c style?

[Ph0enixKM]

Oh yeah we could add the /** */ syntax - I just forgot to add the multiline comments. I didn't the need to implement them - now it's the good time

[Mte90]

If we will go on /** */ syntax we can approve? #238

So in the way I will add all the comments in the stdlib