ctolkien / Slugify

Simple Slug / Clean URL generator helper for Microsoft .NET framework / .NET Standard.
MIT License
93 stars 13 forks source link

Rewrite README for an updated documentation #51

Closed poke closed 1 year ago

poke commented 1 year ago

Fixes #24 and generally improves the documentation of the library. I’ve allowed myself to do some larger changes to the readme since it was still mostly based on the original version by Federico.


Rewrite the documentation in the README file to document the current behavior and configuration options of Slugify.Core. The previous content was still mostly based on the original library which no longer matches the implementation since version 3.0.

Add documentation for the AllowedChars option which now drives the main behavior of the library. Also adjust the documentation of DeniedCharactersRegex to reflect the actual current default (it being disabled in favor of AllowedChars) and describes it as the legacy behavior which is just kept for compatibility reasons.

Also adjust the documentation of the other options and describe the default slug generation behavior in text instead of showing the default configuration object which would be difficult and confusing due to the internals of the AllowedChars set.

ctolkien commented 1 year ago

Thankyooouuuu!