diff --git a/docsource/buildandconfigure.rst b/docsource/buildandconfigure.rst
index 27b7d3db..5a18c43e 100644
--- a/docsource/buildandconfigure.rst
+++ b/docsource/buildandconfigure.rst
@@ -8,14 +8,13 @@ Build the workspace service
 
 Get the code::
 
-    ~$ mkdir kb
-    ~$ cd kb
-    ~/kb$ git clone https://github.com/kbase/workspace_deluxe
+
+    ~$ git clone https://github.com/kbase/workspace_deluxe
 
 Build::
 
-    ~/kb$ cd workspace_deluxe/
-    ~/kb/workspace_deluxe$ ./gradlew buildAll
+    ~$ cd workspace_deluxe/
+    ~/workspace_deluxe$ ./gradlew buildAll
     *snip*
 
 ``buildAll`` will build 3 jars in ``build/libs``:
@@ -25,7 +24,7 @@ Build::
 * A workspace shadow jar containing all test code. This is useful for starting a workpace server
   from other processes without needing a docker container, but should **only** be used for testing.
 
-It will also build the ``build\update_workspace_database_schema`` script which is used to
+It will also build the ``build/update_workspace_database_schema`` script which is used to
 update the workspace schema if it changes from one version to another.
 
 .. _servicedeps:
diff --git a/docsource/developers.rst b/docsource/developers.rst
index 29096ec8..cd3b715c 100644
--- a/docsource/developers.rst
+++ b/docsource/developers.rst
@@ -28,7 +28,9 @@ Note that:
 
 * The `kb-sdk <https://github.com/kbase/kb_sdk>`_ executable must be in the system path.
 * The WorkspaceServer class compiled in constructor has been commented out in order to use
-  a custom constructor. That must be reversed for the compile to work.
+  a custom constructor. In order for the compile to succeed, the custom constructor must be
+  commented out and the compiled in constructor uncommented. When the compile is complete the
+  constructors must be switched back.
 
 Release checklist
 -----------------