doc tweaks

Author: ablaom

docs/src/index.md

@@ -10,7 +10,7 @@ functions:
 
 - It hosts the *MLJ Model Registry*, a list of packages providing MLJ interfaces to
   machine learning algorithms, together with metadata about those models, such as the type
-  of data models can operate on.
+  of data models can operate on, and their document strings.
 
 - It provides software tools for MLJ maintainers to manage the Model Registry, for example
   to add the models provided by a new machine learning package providing an MLJ model

docs/src/registry_management_tools.md

@@ -9,8 +9,8 @@ MLJModelRegistry
 ## Methods
 
 - [`update`](@ref)
-- [`ModelRegistry.gc`](@ref)
-- [`ModelRegistry.get`](@ref)
+- [`MLJModelRegistry.gc`](@ref)
+- [`MLJModelRegistry.get`](@ref)
 
 ```@docs
 update

src/MLJModelRegistry.jl

@@ -7,25 +7,27 @@ Module providing methods for managing the MLJ Model Registry. To modify the regi
   repository](https://github.com/JuliaAI/MLJModelRegistry.jl)
 
 - Use Julia's package manager to add or remove items from the list of registered packages
-  in the environment "/registry/". If adding a new item, see the protocol below.
+  in the environment "/registry/", located in the root directory of your clone. If adding
+  a new item, see the protocol below.
 
 - In a fresh temporary environment, run `Pkg.develop("path_to_clone")` and `using
   MLJModelRegistry`.
 
-- To add or update the metadata associated with a package (compulsory for new packages)
-  run [`update(pkg)`](@ref)
+- To add or update the metadata associated with a package, run [`update(pkg)`](@ref).
 
-- To update the metadata for *all* packages in the registry, run [`update()`](@ref).
+- Alternatively, to update the metadata for *all* packages in the registry (optional but
+  recommended), run [`update()`](@ref).
 
 - When satisfied, commit your changes to the clone and make a pull request to the master
   MLJModelRegistry.jl repository.
 
 !!! important
 
     Removing a package from the "/registry/" enviroment does not remove its metadata from
-    the Model Registry (from "/registry/Metatdata.toml"). Unless you later call `update()`
-    to update all package metadata (slow), you must call [`MLJModelRegistry.gc()`](@ref) to
-    specifically remove metadata for all orphaned packages (fast).
+    the Model Registry (i.e., from "/registry/Metatdata.toml"). Unless you later call
+    `update()` to update all package metadata (slow), you must call
+    [`MLJModelRegistry.gc()`](@ref) to specifically remove metadata for all orphaned
+    packages (fast).
 
 # Protocol for adding new packages to the registry environment
 

src/methods.jl

@@ -71,7 +71,7 @@ strings, and record it in the MLJ model registry (write it to
 `/registry/Metadata.toml`).
 
 Assumes `pkg` is already a dependency in the Julia enviroment defined at `/registry/`. See
-[`MLJModelRegistry`](@ref) for details on the registration process.
+documentation for details on the registration process.
 
 ```julia-repl
 julia> update("MLJDecisionTreeInterface")