Add FAQ entry on combining specs

[ardalis]

No description provided.

[fiseni]

The approach with predicates won't work. EF will throw an exception during the evaluation. Instead, we can write extensions to the builder.

public static class CustomerSpecExtensions
{
    public static ISpecificationBuilder<Customer> IsAdult(this ISpecificationBuilder<Customer> builder)
        => builder.Where(x => x.Age >= 18);

    public static ISpecificationBuilder<Customer> IsAtLeastYearsOld(this ISpecificationBuilder<Customer> builder, int years)
        => builder.Where(x => x.Age >= years);
}

public class AdultCustomersByNameSpec : Specification<Customer>
{
    public AdultCustomersByNameSpec(string nameSubstring)
    {
        Query.IsAdult()
            .Where(x => x.Name.Contains(nameSubstring));
    }
}

We have more examples in the sample apps. https://github.com/ardalis/Specification/blob/main/sample/Ardalis.Sample.Domain/Specs/CustomerSpecExtensions.cs

[fiseni]

We should remove this paragraph. Or, update it and suggest using specification builder extensions.

[fiseni]

We should update this example with the one provided in the PR comments. I updated our sample too, so perhaps you can pick up the code from this commit 924a68c