diff --git a/docs/README.md b/docs/README.md
index 89f3ecbd247..8ac97d5561b 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -30,9 +30,14 @@ p4c
 ├── test                      -- test code
 │   └── gtest                 -- unit test code written using gtest
 ├── tools                     -- external programs used in the build/test process
+│   ├── ci-ptf                -- scripts to run PSA PTF tests
+│   ├── debian-build          -- resources and scripts for creating Ubuntu (or Debian) packages
 │   ├── driver                -- p4c compiler driver: a script that invokes various compilers
-│   ├── stf                   -- Python code to parse STF files (used for testing P4 programs)
-|   └── ir-generator          -- code for the IR C++ class hierarchy generator
+│   ├── hooks                 -- useful git hooks for development
+|   ├── ir-generator          -- code to generate the P4C IR from .def files
+│   ├── iwyu_mappings         -- mappings used by the Include What You Use (IWYU) tool for analyzing #include directives in C and C++ source files
+│   ├── ptf                   -- utilities for the Packet Test Framework (PTF)
+│   └── stf                   -- utilities for the Simple Test Framework (STF)
 └── testdata                  -- test inputs and reference outputs
     ├── p4_16_samples         -- P4_16 input test programs
     ├── p4_16_errors          -- P4_16 negative input test programs