Directories and files

The root stays put. A file sits in one directory. A note is Markdown on a file or a directory. A shortcut is a private bookmark.

Creating a drive creates its root directory. The root name is the drive name. The root cannot be renamed, moved, or deleted, and its deletion protection stays on.

Every other directory has one parent in the same drive. A name is unique among siblings. A file sits in one directory. The path you see is those names. A move changes what you see next and leaves the file in place.

Deletion protection

Deletion protection is a latch on a directory and on a file. In the inspector it is Keep this from being deleted. It is separate from the hold on a file.

  • A directory an editor creates starts protected. Delete stops until an editor clears it.
  • The root starts protected, and that latch cannot be changed.
  • A directory created to place a path from an expanded archive starts unprotected.
  • A file starts unprotected. An editor can turn protection on.
  • While protection is on, delete stops. The message is Deletion protection is on.

Deleting a directory removes that directory and the directories and live files under it. It stops before it changes anything when something inside that you can see is protected or held. The message names the kind of stop and does not name that item. Something you cannot see is left in place and is not named. That message is This folder cannot be deleted.

The hold is a second stop on a file. It ships unset. When it is set, delete stops with This file is held.

Who can see a subtree

A directory may list drive members. When the list is empty, it adds no extra restriction. When it names members, a drive member who is not on the list cannot see the subtree. Tags on the directory still apply. A manager replaces the list. Ending a drive membership removes that member from the lists they were on.

What the inspector shows

The inspector names Kind, Size, Status, Search, and when the file was added. Kind is Image, Table, Document, or File. A folder is a directory.

Status and Search are different.

StatusWhat you see
PendingThe row exists. The bytes are not confirmed. The file is absent from the list, from search, and from SQL.
ReadyThe bytes are confirmed. You can download the file.
DeletingDelete has started. The file is absent. A failed delete stays here and is tried again.
DeletedThe bytes are gone. The row remains.
UnavailableThe row says the file is ready, and the bytes are missing. The file still appears, with the message that the bytes are unavailable.

Search says Indexing while the index is being written, Searchable when the file is in it, and Not in search otherwise. A Ready file can be downloaded while Search still says Indexing or Not in search.

The list shows Ready and Unavailable files. Pending and Deleting stay off it. A file you cannot see is absent.

Notes

A file or a directory, including the root, has a list of notes. A note is Markdown of its own, not a column on the file. The list is oldest first, under the path or under the file.

Opening the file or the directory shows its notes. An editor adds a note, replaces it, or deletes it. A viewer reads it. A blank note is refused with A note is required. A note past the text limit is The note is too long. Deleting the file or the directory deletes its notes.

A raster picture can gain a note that describes it, in the name of the person who uploaded the file. Notes a person wrote stay. The same picture is described once. SVG and a picture over 15 MiB stay as the file.

A note can hold an image or a PDF. That attachment stays on the note. The directory does not list it. It has no path of its own, and it carries no tag or member list. Opening the parent shows it. Search can find its text on the note. The task is on Notes.

Shortcuts

A shortcut is a bookmark you keep on one drive. It points at a directory or a file in that drive. Add shortcut puts it in the side bar for this drive. Remove shortcut takes it off. Opening another drive shows that drive’s shortcuts. A target you cannot see is absent. Opening a shortcut uses the same allow as opening the target.