diff --git a/api/api.go b/api/api.go
index 0dc2d89f..a4d4be16 100644
--- a/api/api.go
+++ b/api/api.go
@@ -1,2 +1,8 @@
 // Package api provides implementation of aptly REST API
 package api
+
+// Lock order acquisition (canonical):
+//  1. RemoteRepoCollection
+//  2. LocalRepoCollection
+//  3. SnapshotCollection
+//  4. PublishedRepoCollection