A DESCRIPTION OF THE PROBLEM :
In class Files
method public static Path write(Path path,
                         Iterable<? extends CharSequence> lines,
                         Charset cs,
                         OpenOption... options)

the last sentence of the 2nd paragraph should read ...

EXPECTED VERSUS ACTUAL BEHAVIOR :
EXPECTED -
If an I/O error occurs then it may do so after the file has BEEN created or truncated, or after some bytes have been written to the file.

(Omitted word in capitals)
ACTUAL -
If an I/O error occurs then it may do so after the file has created or truncated, or after some bytes have been written to the file.

URL OF FAULTY DOCUMENTATION :
http://docs.oracle.com/javase/8/docs/api/index.html