/// <summary>
/// Sets the <paramref name="identityPartsSeparator" /> on the specified document conventions. We recommend you use '-'
/// as the separator, as the default separator '/' might collide with URLs in web apps.
/// </summary>
/// <param name="documentConventions">The document conventions that will be manipulated.</param>
/// <param name="identityPartsSeparator">The character that should be used to separate the different parts of a RavenDB ID (optional). The default value is '-'.</param>
/// <exception cref="ArgumentNullException">Thrown when <paramref name="documentConventions" /> is null.</exception>
public static DocumentConventions SetIdentityPartsSeparator(this DocumentConventions documentConventions, char identityPartsSeparator = DefaultIdentityPartsSeparator)
{
documentConventions.MustNotBeNull(nameof(documentConventions));
documentConventions.IdentityPartsSeparator = identityPartsSeparator;
return(documentConventions);
}