ArchDocs
Start free

Spaces and folders

At Lanefold, a fictional freight company, spaces can group documents by area, such as Booking Platform, Payments or Infrastructure. Folders divide a space when its document list gets hard to scan.

Free includes 1 space, Team includes 5, and Business and above include unlimited spaces. Sample spaces don't count toward these limits. Managing spaces and folders requires spaces:manage; creating, moving and editing documents requires docs:write.

Create a space

  1. Select the New space plus icon beside the sidebar's space groups.
  2. Enter a Space name. Choose a team, or leave Org wide selected.
  3. Select Create, then open the space in the sidebar.

The team choice controls where the space appears in the sidebar. It doesn't restrict access to that team's members.

In a space, select New folder, enter a Folder name, then select Create. Open a folder before creating another folder to nest it there. New doc creates a document in the space or folder you're viewing.

File a draft or move a document

Your drafts on Home lists documents you created that aren't filed in a space. Drafts is a location, not a visibility setting.

  1. On Home or in a space, open the document row's three-dot menu and select Move to….
  2. Choose a Space, then a Folder. Choose Space root to leave it outside the folders.
  3. Select Move.

To unfile a document, choose Drafts (no space) instead. Moving a document into a public space makes it readable through that space's link unless the document is private.

A document attached to an object must be released from the object before you can file it into a space or folder.

Add the context behind a diagram

A description records what the boxes can't: why Dispatch Service depends on Billing Service, or which constraints shaped the design.

  1. Open the document and select Share document in the canvas toolbar.
  2. Under Description, write Markdown in Edit. Use Preview to check it.
  3. Select Save description, then reload the document to see the saved description on the canvas.

The saved description appears in the collapsible About this diagram panel on the canvas. A preview also appears in document lists, and search can match its text. Use a decision record when you need to record alternatives and track a decision's status.

Rename or delete a space or folder

Open Space actions in the space header and choose Space settings to rename the space. Select Save when you're done. A folder's three-dot menu has Rename and Delete.

Deleting a folder removes its subfolders too. Documents inside move to the space root. Delete space moves its documents back to Drafts and removes its folders. Neither action deletes the documents.