docs(api): list 403 ROOT_UNREADABLE among widget dev session refusals

docs/api.html

@@ -546,7 +546,7 @@ <h2 id="widget-dev-sessions">Widget dev sessions</h2>
   <li><strong>Builds.</strong> A build that does not read as a package produces no generation: <code>lastBuild.ok</code> is <code>false</code> with up to 32 <code>diagnostics</code>, the running generation keeps running, and <code>showingLastKnownGood</code> is <code>true</code>. A folder over 5,000 files or 64 MiB fails with <code>FILES_TOO_LARGE</code>, a link out of it with <code>FILES_LINK_REFUSED</code>, and files that could not be read with <code>FILES_UNREADABLE</code>.</li>
   <li><strong>Consent.</strong> Each install is decided under a consent scope: the package id with its declared reach, resources, facet lanes, facets, permissions and requested capabilities. The install question in <code>GET /inbox</code> carries that scope as its <code>operationDigest</code> and is decided on <code>POST /packages/approvals/{approvalId}/decision</code>. A later build with the same scope installs on that approval; a build whose scope changed is a new question, and the generation before it keeps running meanwhile.</li>
   <li><strong>Live read.</strong> <code>GET /conversations/{id}/widgets/{instanceId}/live</code> for a widget running a session's generation carries <code>development: { sessionId }</code>, and its <code>frame.document</code> names the generation, so a client remounts only the frame when a new generation runs.</li>
-  <li><strong>Limits and refusals.</strong> <code>409 TOO_MANY_SESSIONS</code> for a ninth live session, or when the store already holds 256 sessions that all still run what they built. Also <code>400 ROOT_NOT_ABSOLUTE</code>, <code>400 ROOT_NOT_A_FOLDER</code>, <code>404 ROOT_NOT_FOUND</code>, <code>404 CONVERSATION_NOT_FOUND</code>, <code>404 SESSION_NOT_FOUND</code>, <code>409 NOT_ACTIVE</code>, <code>400 NO_SUCH_WIDGET</code>, <code>409 NOT_PLACED</code> and <code>503 WIDGET_DEV_UNAVAILABLE</code>.</li>
+  <li><strong>Limits and refusals.</strong> <code>409 TOO_MANY_SESSIONS</code> for a ninth live session, or when the store already holds 256 sessions that all still run what they built. Also <code>400 ROOT_NOT_ABSOLUTE</code>, <code>400 ROOT_NOT_A_FOLDER</code>, <code>404 ROOT_NOT_FOUND</code>, <code>403 ROOT_UNREADABLE</code> (the folder is there but cannot be read, for example while an antivirus holds it; the message names the error, such as <code>EPERM</code>), <code>404 CONVERSATION_NOT_FOUND</code>, <code>404 SESSION_NOT_FOUND</code>, <code>409 NOT_ACTIVE</code>, <code>400 NO_SUCH_WIDGET</code>, <code>409 NOT_PLACED</code> and <code>503 WIDGET_DEV_UNAVAILABLE</code>.</li>
 </ul>
 
 <h2 id="stop">Stop everything</h2>

vi/docs/api.html

@@ -546,7 +546,7 @@ <h2 id="widget-dev-sessions">Phiên phát triển widget</h2>
   <li><strong>Bản dựng.</strong> Bản dựng không đọc được như một gói thì không tạo thế hệ: <code>lastBuild.ok</code> là <code>false</code> kèm tối đa 32 <code>diagnostics</code>, thế hệ đang chạy vẫn chạy, và <code>showingLastKnownGood</code> là <code>true</code>. Thư mục quá 5.000 tệp hoặc 64 MiB thất bại với <code>FILES_TOO_LARGE</code>, liên kết trỏ ra ngoài với <code>FILES_LINK_REFUSED</code>, và tệp không đọc được với <code>FILES_UNREADABLE</code>.</li>
   <li><strong>Đồng ý.</strong> Mỗi lần cài được quyết định theo một phạm vi đồng ý: id gói cùng phạm vi khai báo, tài nguyên, làn facet, facet, quyền và năng lực được yêu cầu. Câu hỏi cài đặt trong <code>GET /inbox</code> mang phạm vi đó làm <code>operationDigest</code> và được quyết định trên <code>POST /packages/approvals/{approvalId}/decision</code>. Bản dựng sau có cùng phạm vi được cài theo lần chấp thuận đó; bản dựng có phạm vi thay đổi là một câu hỏi mới, và thế hệ trước đó vẫn chạy trong lúc chờ.</li>
   <li><strong>Đọc trực tiếp.</strong> <code>GET /conversations/{id}/widgets/{instanceId}/live</code> với widget đang chạy một thế hệ của phiên mang <code>development: { sessionId }</code>, và <code>frame.document</code> của nó nêu thế hệ đó, để client chỉ gắn lại khung khi có thế hệ mới chạy.</li>
-  <li><strong>Giới hạn và từ chối.</strong> <code>409 TOO_MANY_SESSIONS</code> cho phiên đang chạy thứ chín, hoặc khi kho đã giữ 256 phiên mà tất cả vẫn chạy thứ chúng đã dựng. Ngoài ra còn <code>400 ROOT_NOT_ABSOLUTE</code>, <code>400 ROOT_NOT_A_FOLDER</code>, <code>404 ROOT_NOT_FOUND</code>, <code>404 CONVERSATION_NOT_FOUND</code>, <code>404 SESSION_NOT_FOUND</code>, <code>409 NOT_ACTIVE</code>, <code>400 NO_SUCH_WIDGET</code>, <code>409 NOT_PLACED</code> và <code>503 WIDGET_DEV_UNAVAILABLE</code>.</li>
+  <li><strong>Giới hạn và từ chối.</strong> <code>409 TOO_MANY_SESSIONS</code> cho phiên đang chạy thứ chín, hoặc khi kho đã giữ 256 phiên mà tất cả vẫn chạy thứ chúng đã dựng. Ngoài ra còn <code>400 ROOT_NOT_ABSOLUTE</code>, <code>400 ROOT_NOT_A_FOLDER</code>, <code>404 ROOT_NOT_FOUND</code>, <code>403 ROOT_UNREADABLE</code> (thư mục vẫn còn đó nhưng không đọc được, chẳng hạn khi phần mềm diệt virus đang giữ nó; thông báo ghi rõ lỗi, ví dụ <code>EPERM</code>), <code>404 CONVERSATION_NOT_FOUND</code>, <code>404 SESSION_NOT_FOUND</code>, <code>409 NOT_ACTIVE</code>, <code>400 NO_SUCH_WIDGET</code>, <code>409 NOT_PLACED</code> và <code>503 WIDGET_DEV_UNAVAILABLE</code>.</li>
 </ul>
 
 <h2 id="stop">Dừng mọi thứ</h2>