From 4d8d951a6ba2efe826acbb431db2cc297d799fc2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Richard=20K=C3=B6rber?= <github@shredzone.org>
Date: Tue, 17 Apr 2018 22:43:48 +0200
Subject: [PATCH] Note that some lists have no specific order

---
 .../src/main/java/org/shredzone/acme4j/Account.java        | 7 ++++---
 .../src/main/java/org/shredzone/acme4j/Authorization.java  | 2 +-
 .../src/main/java/org/shredzone/acme4j/Order.java          | 2 +-
 3 files changed, 6 insertions(+), 5 deletions(-)

diff --git a/acme4j-client/src/main/java/org/shredzone/acme4j/Account.java b/acme4j-client/src/main/java/org/shredzone/acme4j/Account.java
index 988a10d2..9d4c4d4d 100644
--- a/acme4j-client/src/main/java/org/shredzone/acme4j/Account.java
+++ b/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();
diff --git a/acme4j-client/src/main/java/org/shredzone/acme4j/Authorization.java b/acme4j-client/src/main/java/org/shredzone/acme4j/Authorization.java
index 49edd8ef..2d864726 100644
--- a/acme4j-client/src/main/java/org/shredzone/acme4j/Authorization.java
+++ b/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();
diff --git a/acme4j-client/src/main/java/org/shredzone/acme4j/Order.java b/acme4j-client/src/main/java/org/shredzone/acme4j/Order.java
index 2ccf9c6b..de0e4005 100644
--- a/acme4j-client/src/main/java/org/shredzone/acme4j/Order.java
+++ b/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();