cordova-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From jasongin <...@git.apache.org>
Subject [GitHub] cordova-plugin-file pull request: adding sample section to readme
Date Thu, 07 Apr 2016 19:17:33 GMT
Github user jasongin commented on a diff in the pull request:

    https://github.com/apache/cordova-plugin-file/pull/176#discussion_r58928914
  
    --- Diff: README.md ---
    @@ -36,7 +36,9 @@ Although most of the plugin code was written when an earlier spec was
current:
     It also implements the FileWriter spec :
     [http://dev.w3.org/2009/dap/file-system/file-writer.html](http://dev.w3.org/2009/dap/file-system/file-writer.html)
     
    -For usage, please refer to HTML5 Rocks' excellent [FileSystem article.](http://www.html5rocks.com/en/tutorials/file/filesystem/)
    +>*Note* For Cordova clients that run in native WebViews (for example, iOS and Android)
or as native apps (Windows), many of the W3C APIs FileSystem are supported. This is true for
the platforms listed in the _Supported Platforms_ list except the Browser platform. On the
Browser platform, many of these APIs are deprecated.
    --- End diff --
    
    "W3C APIs FileSystem" => "W3C FileSystem APIs"
    
    Avoid the term "native apps" to refer to Cordova apps on Windows. Even though Windows
has built-in support for HTML/JS apps, most developers would not consider Cordova apps to
be "native". (also on line 562)
    
    How about something like this:
     While the W3C FileSystem spec is deprecated for web browsers, the FileSystem APIs are
supported in Cordova applications with this plugin for the platforms listed in the Supported
Platforms list, with the exception of the Browser platform.


---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastructure@apache.org or file a JIRA ticket
with INFRA.
---

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@cordova.apache.org
For additional commands, e-mail: dev-help@cordova.apache.org


Mime
View raw message