diff --git a/docs/api/file-object.md b/docs/api/file-object.md
index 36154cdd6a1f..c98b8bd19ec6 100644
--- a/docs/api/file-object.md
+++ b/docs/api/file-object.md
@@ -1,11 +1,10 @@
 # `File` object
 
 The DOM's File interface provides abstraction around native files, in order to
-let users work on native files directly with HTML5 file API, Electron has
-added a `path` attribute to `File` interface which exposes the file's real path
-on filesystem.
+let users work on native files directly with the HTML5 file API. Electron has
+added a `path` attribute to the `File` interface which exposes the file's real path on filesystem.
 
-Example on getting real path of a dragged file:
+Example on getting a real path from a dragged-onto-the-app file:
 
 ```html
 <div id="holder">