Improve docs for sanitize_title()

[ericlewis]

It's not immediately clear what sanitize_title() does. Adding doc modifications.

After looking at the ​PHP Documentation Standards I made some small adjustments to your patch, adding/removing newlines and backticks where necessary.

Sanitizes a string for use as a slug in a URL. is incomplete. Also sanitizes for use as HTML id or class attribute value. There may be other uses...

See comment:3 for other use cases we need to cover.

Still some work left here. Let's move it off the milestone until there's a consensus on the best way to document the intent vs the actual usage of these functions. I'd probably suggest going the route of describing the literal characters removed or accepted for any of these formatting functions – since they tend to get used in all sorts of contexts unrelated to the original intent.

@DrewAPicture Can i have this ticket please?

Replying to psdtohtmlguru:

@DrewAPicture Can i have this ticket please?

A ticket does not belong to anybody, so feel free to submit a patch as you like :)

Assigning to mark the good-first-bug as "claimed".

@psdtohtmlguru, still interested in making a patch?

@SergeyBiryukov Yes, i will submit soon.

There's a tutorial for working with patches in the handbook: ​https://make.wordpress.org/core/handbook/tutorials/working-with-patches/

After creating a patch file you can upload it here to this ticket.

Interested in taking this and finishing it. What are we trying to say at this point? Not sure on the language from reading comments.

`

Rephrasing what sanitize_title() does

@wonderboymusic

Sanitizes a string for use as a slug in a URL. is incomplete. Also sanitizes for use as HTML id or class attribute value. There may be other uses...

Not sure if I'm missing something here, but basically sanitize_title() strip tags, removes accents and replace special characters, right? I'm not really sure what you mean with id or class attribute value.

Rephrased again, special characters are replaced too.

Maybe it's just that the sanitize_title function is sometimes used to generate an id or class from a string to ensure that non authorized characters are not used... Maybe useful only when generating attributes from inputed text.

Replying to gma992:

@wonderboymusic

Sanitizes a string for use as a slug in a URL. is incomplete. Also sanitizes for use as HTML id or class attribute value. There may be other uses...

Not sure if I'm missing something here, but basically sanitize_title() strip tags, removes accents and replace special characters, right? I'm not really sure what you mean with id or class attribute value.