From 9012f7b3d6032412984f439ea877d26b80ac8a5d Mon Sep 17 00:00:00 2001 From: Jay McCarthy Date: Fri, 20 Dec 2013 16:29:37 -0700 Subject: [PATCH] Adding suggestion about 1.0 package versions --- .../racket-doc/pkg/scribblings/getting-started.scrbl | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/pkgs/racket-pkgs/racket-doc/pkg/scribblings/getting-started.scrbl b/pkgs/racket-pkgs/racket-doc/pkg/scribblings/getting-started.scrbl index bf1bc2ea8e..60410411ac 100644 --- a/pkgs/racket-pkgs/racket-doc/pkg/scribblings/getting-started.scrbl +++ b/pkgs/racket-pkgs/racket-doc/pkg/scribblings/getting-started.scrbl @@ -472,7 +472,10 @@ changing a version is optional, and the @tech{package catalog} ignores version declarations; in particular, a package is a candidate for updating when its @tech{checksum} changes, independent of whether the package's version changes or even in which direction the version -changes.} +changes. We suggest using a version smaller than @racket["1.0"] to +indicate that a package's interface is unstable and changing it to +@racket["1.0"] when you are ready to commit to backwards compatibility +going forward.} @item{Packages should not combine large sets of utilities libraries with other functionality. For example,