diff --git a/docs/develop/getting-started/instance-development.md b/docs/develop/getting-started/instance-development.md
index ccd327ef..b3fc0d72 100644
--- a/docs/develop/getting-started/instance-development.md
+++ b/docs/develop/getting-started/instance-development.md
@@ -43,7 +43,7 @@ First, checkout the [package development guide](package-development.md) to learn
 how to develop on a single Python package. To integrate your Python package into
 a development install of an InvenioRDM instance see below:
 
-**Install a module in an instance**
+#### Install a module in an instance
 
 Once you have a source code checkout, you can install the module in the
 development instance:
@@ -69,25 +69,28 @@ invenio-cli run
         invenio-cli services destroy
         invenio-cli services setup
 
+#### Install a forked package in an instance
+
 In some cases you might want to include a forked package in your InvenioRDM 
 instance permanently. For example, you might have a local identifier scheme that 
 you want [idutils](https://github.com/inveniosoftware/idutils) 
 to verify. It wouldn't be appropriate to make a pull request, since this
 change is only relevant to your organization. You can make your fork available on GitHub
-and add the following to your Pipfile
+and add the following to your Pipfile:
 
 ```
 [packages]
 idutils = {git = "https://github.com/your-username/idutils.git", ref = "main"}
 ```
 
-You may need to delete your Pipfile.lock and run `invenio-cli install` the first time you make this change.
+You will need to update your `Pipfile.lock` after this kind of change. Run
+`pipenv lock` or `invenio-cli install`.
 
 !!! warning
     It's not recommended to do this with invenio packages that change often,
     since it will be difficult to keep your fork up to date.
 
-**Edit CSS and JavaScript included in Python modules**
+#### Edit CSS and JavaScript included in Python modules
 
 Some Python modules includes CSS/JavaScript which is usually located in
 ``assets/`` folders in the project.