Proposal for v2 lockfile format (#42)

build.sbt

@@ -20,7 +20,7 @@ organizationName := "Michael Stringer"
 startYear        := Some(2019)
 licenses += ("Apache-2.0", url("https://www.apache.org/licenses/LICENSE-2.0.txt"))
 
-scriptedLaunchOpts           := {
+scriptedLaunchOpts := {
   scriptedLaunchOpts.value ++
     Seq("-Xmx1024M", "-Dplugin.version=" + version.value)
 }
@@ -31,13 +31,14 @@ developers := List(
   Developer("stringbean", "Michael Stringer", "@the_stringbean", url("/~https://github.com/stringbean")),
 )
 
-homepage       := Some(url("/~https://github.com/stringbean/sbt-dependency-lock"))
-scmInfo        := Some(
+homepage               := Some(url("/~https://github.com/stringbean/sbt-dependency-lock"))
+scmInfo                := Some(
   ScmInfo(
     url("/~https://github.com/stringbean/sbt-dependency-lock"),
     "/~https://github.com/stringbean/sbt-dependency-lock.git"))
-git.remoteRepo := "git@github.com:stringbean/sbt-dependency-lock.git"
-publishTo      := sonatypePublishToBundle.value
+git.remoteRepo         := "git@github.com:stringbean/sbt-dependency-lock.git"
+paradoxNavigationDepth := 3
+publishTo              := sonatypePublishToBundle.value
 
 import sbtrelease.ReleasePlugin.autoImport.ReleaseTransformations.*
 

src/main/paradox/file-formats/index.md

@@ -4,12 +4,15 @@ _sbt-dependency-lock_ stores lockfile information in JSON format with a version
 top-level object. Details of the file format can be found on these pages, and we encourage other tools to utilise the
 output information.
 
-| Version                | Added In | Removed In | Description      |
-| ---------------------: | -------: | ---------: | ---------------- |
-| @ref:[1](version-1.md) |    0.1.0 |  _current_ | Initial version. |
+| Version                | Added In   | Removed In | Description               |
+| ---------------------: | ---------: | ---------: | ------------------------- |
+| @ref:[1](version-1.md) |      0.1.0 |  _current_ | Initial version.          |
+| @ref:[2](version-2.md) | _proposed_ |      _N/A_ | Proposed enhanced format. |
+
 
 Current default version is: 1
 
 @@@ index
 * [Version 1](version-1.md)
+* [Version 2](version-2.md)
 @@@

src/main/paradox/file-formats/version-1.md

@@ -1,7 +1,8 @@
-# Version 1
+# Version 1 (current)
 
 * **Added in:** 0.1.0
 * **Removed in:** _N/A_
+* **Schema:** [lockfile-v1.schema.json](../lockfile-v1.schema.json)
 
 ## Types
 
@@ -13,7 +14,7 @@ dependencies.
 #### lockVersion
 
 * **Type:** Integer.
-* **Description:** Version of the lockfile - always 1.
+* **Description:** Version of the lockfile: `1`.
 
 #### timestamp