diff --git a/doc/advanced/hacking-on-gitea.en-us.md b/doc/advanced/hacking-on-gitea.en-us.md
index a76aacc9..e6ffe908 100644
--- a/doc/advanced/hacking-on-gitea.en-us.md
+++ b/doc/advanced/hacking-on-gitea.en-us.md
@@ -151,6 +151,10 @@ make lint-frontend
 
 Note: When working on frontend code, set `USE_SERVICE_WORKER` to `false` in `app.ini` to prevent undesirable caching of frontend assets.
 
+### Building and adding SVGs
+
+SVG icons are built using the `make svg` target which compiles the icon sources defined in `build/generate-svg.js` into the output directory `public/img/svg`. Custom icons can be added in the `web_src/svg` directory.
+
 ### Building Images
 
 To build the images, ImageMagick, `inkscape` and `zopflipng` binaries must be available in