deprecate createOptional interface

Author: jk-idealo

README.md

@@ -115,8 +115,8 @@ ArrayList:
 ### Customize Property With Lambda
 ```java
 TestDto result = fixture.build(TestDto.class)
-                        .with(x -> x.myPublicField = 123)
                         .with(x -> x.setMyPrivateField("HELLO!"))
+                        .with(x -> x.myPublicField = 123)
                         .create();
 ```
 #### Sample Result
@@ -186,18 +186,6 @@ Optional result = fixture.create(SpecimenType.fromClass(Optional.class));
 Optional result = fixture.create(Optional.class); // convenience method for above
 ```
 
-## Optionals
-To quickly create an `Optional<T>` of your desired type `T` without the need to use `SpecimenType<Optional<T>>` as described [above](#generics), here is some syntactic sugar:
-```java
-Optional<String> result = fixture.createOptional(String.class);
-```
-Or with customisation:
-```java
-Optional<TestDto> result = fixture.build(TestDto.class)
-                                  .without("myPublicField")
-                                  .createOptional();
-```
-
 ## Constructor
 There might be some cases when you want to create an object not by instantiating it and setting all fields, but by calling one of its constructors and feeding it random values.
 ```java

src/main/java/com/github/nylle/javafixture/Fixture.java

@@ -80,7 +80,10 @@ public <T> T create(final Class<T> type) {
      * @param type the {@code Class<T>} based on which the object is created
      * @param <T> the type of the object to be created
      * @return a new {@code Optional} of the specified {@code Class<T>}
+     *
+     * This feature is deprecated without replacement.
      */
+    @Deprecated(forRemoval = true)
     public <T> Optional<T> createOptional(final Class<T> type) {
         return new SpecimenBuilder<T>(SpecimenType.fromClass(type), configuration).createOptional();
     }

src/main/java/com/github/nylle/javafixture/SpecimenBuilder.java

@@ -35,7 +35,10 @@ public T create() {
 
     /**
      * @return a new {@code Optional<T>} based on this {@code ISpecimenBuilder<T>}
+     *
+     * This feature is deprecated without replacement.
      */
+    @Deprecated(forRemoval = true)
     @Override
     public Optional<T> createOptional() {
         return Optional.of(create());