From 7ce3571270cc09d12bf578078d1ebe5c8bdfc0e2 Mon Sep 17 00:00:00 2001
From: rreimann <robert.reimann@googlemail.com>
Date: Fri, 21 Apr 2017 15:14:56 +0200
Subject: [PATCH] Clarify requirements for resumable downloads

---
 docs/api/download-item.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/api/download-item.md b/docs/api/download-item.md
index 6603b619aaf9..768d2f7bb23d 100644
--- a/docs/api/download-item.md
+++ b/docs/api/download-item.md
@@ -100,6 +100,8 @@ Returns `Boolean` - Whether the download is paused.
 
 Resumes the download that has been paused.
 
+**Note:** To enable resumable downloads in the narrow sense the server you are downloading from must support range requests and provide a Last-Modified as well as an ETag header value. Otherwise `resume()` will dismiss previously received bytes and restart the download from the beginning. 
+
 #### `downloadItem.canResume()`
 
 Resumes `Boolean` - Whether the download can resume.