Improve docs

Signed-off-by: Luis Mastrangelo <[email protected]>

README.md

@@ -23,10 +23,17 @@ Make sure both the `server` submodule [`sourcify`](./sourcify/) and the `reposit
 git submodule update --init --recursive
 ```
 
-These repo submodules are the `server` and `repository` Sourcify upstream services.
+These repo submodules are `sourcify` and `h5ai-nginx`, which corresponds to the `server` and `repository` Sourcify upstream services respectively.
 Instead of forking those repos, we attach them here directly in order to consume upstream updates more easily.
 Given that the `ui` changes are Hedera specific, we decided to keep our [`ui`](./ui/) fork with custom modifications.
 
+Apply the Hedera customization patch to both the `sourcify` and `h5ai-nginx` submodules **(execute this only once)**
+
+```sh
+npm run server:patch
+npm run repository:patch
+```
+
 ## Quick Start
 
 To start the services `server`, `repository` and `ui` run

tools/README.md

@@ -82,6 +82,10 @@ module.exports = {
 };
 ```
 
+> [!NOTE]
+> Both `apiUrl` and `browserUrl` expect an URL without a trailing slash.
+> Having a trailing slash in the Sourcify URLs may cause unexpected errors.
+
 Note that the `hardhat-verify` plugin has Etherscan enabled by default, and Sourcify disabled by default, hence you need to set both flags as above in the configuration.
 
 Then run