move docs

Author: aignas

python/uv/lock.bzl

@@ -14,6 +14,32 @@
 
 """The `uv` locking rule.
 
+Differences with the legacy {obj}`compile_pip_requirements` rule:
+- This is implemented as a rule that performs locking in a build action.
+- Additionally one can use the runnable target.
+- Uses `uv`.
+- This does not error out if the output file does not exist yet.
+- Supports transitions out of the box.
+
+Note, this does not provide a `test` target, if you would like to add a test
+target that always does the locking automatically to ensure that the
+`requirements.txt` file is up-to-date, add something similar to:
+
+```starlark
+load("@bazel_skylib//rules:native_binary.bzl", "native_test")
+load("@rules_python//python/uv:lock.bzl", "lock")
+
+lock(
+    name = "requirements",
+    srcs = ["pyproject.toml"],
+)
+
+native_test(
+    name = "requirements_test",
+    src = "requirements.update",
+)
+```
+
 EXPERIMENTAL: This is experimental and may be removed without notice
 """
 

python/uv/private/lock.bzl

@@ -12,33 +12,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-"""A simple macro to lock the requirements.
-
-Differences with the legacy {obj}`compile_pip_requirements` rule:
-- This is implemented as a rule that performs locking in a build action.
-- Additionally one can use the runnable target.
-- Uses `uv`.
-- This does not error out if the output file does not exist yet.
-- Supports transitions out of the box.
-
-Note, this does not provide a `test` target, if you would like to add a test
-target that always does the locking automatically to ensure that the
-`requirements.txt` file is up-to-date, add something similar to:
-
-```starlark
-load("@bazel_skylib//rules:native_binary.bzl", "native_test")
-load("@rules_python//python/uv:lock.bzl", "lock")
-
-lock(
-    name = "requirements",
-    srcs = ["pyproject.toml"],
-)
-
-native_test(
-    name = "requirements_test",
-    src = "requirements.update",
-)
-```
+"""An implementation for a simple macro to lock the requirements.
 """
 
 load("@bazel_skylib//lib:shell.bzl", "shell")