Note that some lists have no specific order

acme4j-client/src/main/java/org/shredzone/acme4j/Account.java

@@ -98,10 +98,11 @@ public class Account extends AcmeJsonResource {
      * <p>
      * Using the iterator will initiate one or more requests to the ACME server.
      *
-     * @return {@link Iterator} instance that returns {@link Order} objects.
-     *         {@link Iterator#hasNext()} and {@link Iterator#next()} may throw
+     * @return {@link Iterator} instance that returns {@link Order} objects in no specific
+     *         order. {@link Iterator#hasNext()} and {@link Iterator#next()} may throw
      *         {@link AcmeProtocolException} if a batch of authorization URIs could not be
-     *         fetched from the server.
+     *         fetched from the server. Each {@link Iterator} instance may provide the
+     *         {@link Order} objects in a different order.
      */
     public Iterator<Order> getOrders() throws AcmeException {
         URL ordersUrl = getJSON().get(KEY_ORDERS).asURL();

acme4j-client/src/main/java/org/shredzone/acme4j/Authorization.java

@@ -95,7 +95,7 @@ public class Authorization extends AcmeJsonResource {
     }
 
     /**
-     * Gets a list of all challenges offered by the server.
+     * Gets a list of all challenges offered by the server, in no specific order.
      */
     public List<Challenge> getChallenges() {
         Login login = getLogin();

acme4j-client/src/main/java/org/shredzone/acme4j/Order.java

@@ -97,7 +97,7 @@ public class Order extends AcmeJsonResource {
     }
 
     /**
-     * Gets the {@link Authorization} required for this order.
+     * Gets the {@link Authorization} required for this order, in no specific order.
      */
     public List<Authorization> getAuthorizations() {
         Login login = getLogin();