diff --git a/api/graph.go b/api/graph.go
index efeb8384..78d4958f 100644
--- a/api/graph.go
+++ b/api/graph.go
@@ -26,7 +26,7 @@ import (
 // @Description
 // @Description Example URL: `http://localhost:8080/api/graph.svg?layout=vertical`
 // @Tags Status
-// @Produce json
+// @Produce image/png, image/svg+xml
 // @Param ext path string true "ext specifies desired file extension, e.g. .png, .svg."
 // @Param layout query string false "Change between a `horizontal` (default) and a `vertical` graph layout."
 // @Success 200 {object} []byte "Output"
diff --git a/api/mirror.go b/api/mirror.go
index 952c67d3..f121d2bf 100644
--- a/api/mirror.go
+++ b/api/mirror.go
@@ -83,7 +83,7 @@ type mirrorCreateParams struct {
 }
 
 // @Summary Create Mirror
-// @Description **Create a mirror of a remote repositoru**
+// @Description **Create a mirror of a remote repository**
 // @Tags Mirrors
 // @Consume json
 // @Param request body mirrorCreateParams true "Parameters"
diff --git a/api/snapshot.go b/api/snapshot.go
index ba94b191..6138b3de 100644
--- a/api/snapshot.go
+++ b/api/snapshot.go
@@ -14,8 +14,9 @@ import (
 	"github.com/gin-gonic/gin"
 )
 
-// @Summary Get snapshots
-// @Description **Get list of available snapshots**
+// @Summary List Snapshots
+// @Description **Get list of snapshots**
+// @Description
 // @Description Each snapshot is returned as in “show” API.
 // @Tags Snapshots
 // @Produce  json
@@ -45,8 +46,8 @@ type snapshotsCreateFromMirrorParams struct {
 	Description string
 }
 
-// @Summary Create snapshot from mirror
-// @Description **Create snapshot of a mirror from given name**
+// @Summary Snapshot Mirror
+// @Description **Create a snapshot of a mirror**
 // @Tags Snapshots
 // @Produce json
 // @Param request body snapshotsCreateFromMirrorParams true "Parameters"
@@ -119,8 +120,9 @@ type snapshotsCreateParams struct {
 	PackageRefs     []string
 }
 
-// @Summary Create snapshot from repo
+// @Summary Snapshot Packages
 // @Description **Create a snapshot from package refs**
+// @Description
 // @Description Refs can be obtained from snapshots, local repos, or mirrors
 // @Tags Snapshots
 // @Param request body snapshotsCreateParams true "Parameters"
diff --git a/docs/Snapshots.md b/docs/Snapshots.md
index e8f41b75..d6db4a4d 100644
--- a/docs/Snapshots.md
+++ b/docs/Snapshots.md
@@ -1,4 +1,8 @@
 # Manage Snapshots of Repositories and Mirrors
 <div>
-Snapshot is a fixed state of remote repository mirror or local repository. Internally snapshot is list of references to packages. Snapshot is immutable, i.e. it can’t be changed since it has been created. Snapshots could be merged, filtered, individual packages could be pulled, snapshot could be verified for missing dependencies. Finally, snapshots could be published as repositories.
+
+Local Repositories and Mirrors can be snapshotted to get an immutable state.
+
+Snapshots cab be merged, filtered, verified for missing dependencies. Snapshots can be published to be used as APT source.
+
 </div>