diff --git a/hw/ip/_index.md b/hw/ip/README.md
similarity index 100%
rename from hw/ip/_index.md
rename to hw/ip/README.md
diff --git a/hw/ip/adc_ctrl/doc/_index.md b/hw/ip/adc_ctrl/README.md
similarity index 100%
rename from hw/ip/adc_ctrl/doc/_index.md
rename to hw/ip/adc_ctrl/README.md
diff --git a/hw/ip/adc_ctrl/doc/dv/index.md b/hw/ip/adc_ctrl/dv/README.md
similarity index 100%
rename from hw/ip/adc_ctrl/doc/dv/index.md
rename to hw/ip/adc_ctrl/dv/README.md
diff --git a/hw/ip/adc_ctrl/doc/dv/tb.svg b/hw/ip/adc_ctrl/dv/doc/tb.svg
similarity index 100%
rename from hw/ip/adc_ctrl/doc/dv/tb.svg
rename to hw/ip/adc_ctrl/dv/doc/tb.svg
diff --git a/hw/ip/aes/doc/_index.md b/hw/ip/aes/README.md
similarity index 100%
rename from hw/ip/aes/doc/_index.md
rename to hw/ip/aes/README.md
diff --git a/hw/ip/aes/doc/dv/index.md b/hw/ip/aes/dv/README.md
similarity index 100%
rename from hw/ip/aes/doc/dv/index.md
rename to hw/ip/aes/dv/README.md
diff --git a/hw/ip/aes/doc/dv/aes_tb.svg b/hw/ip/aes/dv/doc/aes_tb.svg
similarity index 100%
rename from hw/ip/aes/doc/dv/aes_tb.svg
rename to hw/ip/aes/dv/doc/aes_tb.svg
diff --git a/hw/ip/aon_timer/doc/_index.md b/hw/ip/aon_timer/README.md
similarity index 100%
rename from hw/ip/aon_timer/doc/_index.md
rename to hw/ip/aon_timer/README.md
diff --git a/hw/ip/aon_timer/doc/dv/index.md b/hw/ip/aon_timer/dv/README.md
similarity index 100%
rename from hw/ip/aon_timer/doc/dv/index.md
rename to hw/ip/aon_timer/dv/README.md
diff --git a/hw/ip/aon_timer/doc/dv/domains.svg b/hw/ip/aon_timer/dv/doc/domains.svg
similarity index 100%
rename from hw/ip/aon_timer/doc/dv/domains.svg
rename to hw/ip/aon_timer/dv/doc/domains.svg
diff --git a/hw/ip/aon_timer/doc/dv/tb.svg b/hw/ip/aon_timer/dv/doc/tb.svg
similarity index 100%
rename from hw/ip/aon_timer/doc/dv/tb.svg
rename to hw/ip/aon_timer/dv/doc/tb.svg
diff --git a/hw/ip/clkmgr/doc/_index.md b/hw/ip/clkmgr/README.md
similarity index 100%
rename from hw/ip/clkmgr/doc/_index.md
rename to hw/ip/clkmgr/README.md
diff --git a/hw/ip/clkmgr/doc/dv/index.md b/hw/ip/clkmgr/dv/README.md
similarity index 100%
rename from hw/ip/clkmgr/doc/dv/index.md
rename to hw/ip/clkmgr/dv/README.md
diff --git a/hw/ip/clkmgr/doc/dv/tb.svg b/hw/ip/clkmgr/dv/doc/tb.svg
similarity index 100%
rename from hw/ip/clkmgr/doc/dv/tb.svg
rename to hw/ip/clkmgr/dv/doc/tb.svg
diff --git a/hw/ip/csrng/doc/_index.md b/hw/ip/csrng/README.md
similarity index 100%
rename from hw/ip/csrng/doc/_index.md
rename to hw/ip/csrng/README.md
diff --git a/hw/ip/csrng/doc/dv/index.md b/hw/ip/csrng/dv/README.md
similarity index 100%
rename from hw/ip/csrng/doc/dv/index.md
rename to hw/ip/csrng/dv/README.md
diff --git a/hw/ip/csrng/doc/dv/csrng_tb.svg b/hw/ip/csrng/dv/doc/csrng_tb.svg
similarity index 100%
rename from hw/ip/csrng/doc/dv/csrng_tb.svg
rename to hw/ip/csrng/dv/doc/csrng_tb.svg
diff --git a/hw/ip/edn/doc/_index.md b/hw/ip/edn/README.md
similarity index 100%
rename from hw/ip/edn/doc/_index.md
rename to hw/ip/edn/README.md
diff --git a/hw/ip/edn/doc/dv/index.md b/hw/ip/edn/dv/README.md
similarity index 100%
rename from hw/ip/edn/doc/dv/index.md
rename to hw/ip/edn/dv/README.md
diff --git a/hw/ip/edn/doc/dv/edn_tb.svg b/hw/ip/edn/dv/doc/edn_tb.svg
similarity index 100%
rename from hw/ip/edn/doc/dv/edn_tb.svg
rename to hw/ip/edn/dv/doc/edn_tb.svg
diff --git a/hw/ip/entropy_src/doc/_index.md b/hw/ip/entropy_src/README.md
similarity index 100%
rename from hw/ip/entropy_src/doc/_index.md
rename to hw/ip/entropy_src/README.md
diff --git a/hw/ip/entropy_src/doc/dv/index.md b/hw/ip/entropy_src/dv/README.md
similarity index 100%
rename from hw/ip/entropy_src/doc/dv/index.md
rename to hw/ip/entropy_src/dv/README.md
diff --git a/hw/ip/entropy_src/doc/dv/entropy_src_tb.svg b/hw/ip/entropy_src/dv/doc/entropy_src_tb.svg
similarity index 100%
rename from hw/ip/entropy_src/doc/dv/entropy_src_tb.svg
rename to hw/ip/entropy_src/dv/doc/entropy_src_tb.svg
diff --git a/hw/ip/flash_ctrl/doc/_index.md b/hw/ip/flash_ctrl/README.md
similarity index 100%
rename from hw/ip/flash_ctrl/doc/_index.md
rename to hw/ip/flash_ctrl/README.md
diff --git a/hw/ip/flash_ctrl/doc/dv/index.md b/hw/ip/flash_ctrl/dv/README.md
similarity index 100%
rename from hw/ip/flash_ctrl/doc/dv/index.md
rename to hw/ip/flash_ctrl/dv/README.md
diff --git a/hw/ip/flash_ctrl/doc/dv/tb.svg b/hw/ip/flash_ctrl/dv/doc/tb.svg
similarity index 100%
rename from hw/ip/flash_ctrl/doc/dv/tb.svg
rename to hw/ip/flash_ctrl/dv/doc/tb.svg
diff --git a/hw/ip/gpio/doc/_index.md b/hw/ip/gpio/README.md
similarity index 100%
rename from hw/ip/gpio/doc/_index.md
rename to hw/ip/gpio/README.md
diff --git a/hw/ip/gpio/doc/dv/index.md b/hw/ip/gpio/dv/README.md
similarity index 100%
rename from hw/ip/gpio/doc/dv/index.md
rename to hw/ip/gpio/dv/README.md
diff --git a/hw/ip/gpio/doc/dv/tb.svg b/hw/ip/gpio/dv/doc/tb.svg
similarity index 100%
rename from hw/ip/gpio/doc/dv/tb.svg
rename to hw/ip/gpio/dv/doc/tb.svg
diff --git a/hw/ip/hmac/doc/_index.md b/hw/ip/hmac/README.md
similarity index 100%
rename from hw/ip/hmac/doc/_index.md
rename to hw/ip/hmac/README.md
diff --git a/hw/ip/hmac/doc/dv/index.md b/hw/ip/hmac/dv/README.md
similarity index 100%
rename from hw/ip/hmac/doc/dv/index.md
rename to hw/ip/hmac/dv/README.md
diff --git a/hw/ip/hmac/doc/dv/tb.svg b/hw/ip/hmac/dv/doc/tb.svg
similarity index 100%
rename from hw/ip/hmac/doc/dv/tb.svg
rename to hw/ip/hmac/dv/doc/tb.svg
diff --git a/hw/ip/i2c/doc/_index.md b/hw/ip/i2c/README.md
similarity index 100%
rename from hw/ip/i2c/doc/_index.md
rename to hw/ip/i2c/README.md
diff --git a/hw/ip/i2c/doc/dv/index.md b/hw/ip/i2c/dv/README.md
similarity index 100%
rename from hw/ip/i2c/doc/dv/index.md
rename to hw/ip/i2c/dv/README.md
diff --git a/hw/ip/i2c/doc/dv/tb.svg b/hw/ip/i2c/dv/doc/tb.svg
similarity index 100%
rename from hw/ip/i2c/doc/dv/tb.svg
rename to hw/ip/i2c/dv/doc/tb.svg
diff --git a/hw/ip/keymgr/doc/_index.md b/hw/ip/keymgr/README.md
similarity index 100%
rename from hw/ip/keymgr/doc/_index.md
rename to hw/ip/keymgr/README.md
diff --git a/hw/ip/keymgr/doc/dv/index.md b/hw/ip/keymgr/dv/README.md
similarity index 100%
rename from hw/ip/keymgr/doc/dv/index.md
rename to hw/ip/keymgr/dv/README.md
diff --git a/hw/ip/keymgr/doc/dv/tb.svg b/hw/ip/keymgr/dv/doc/tb.svg
similarity index 100%
rename from hw/ip/keymgr/doc/dv/tb.svg
rename to hw/ip/keymgr/dv/doc/tb.svg
diff --git a/hw/ip/kmac/doc/_index.md b/hw/ip/kmac/README.md
similarity index 100%
rename from hw/ip/kmac/doc/_index.md
rename to hw/ip/kmac/README.md
diff --git a/hw/ip/kmac/doc/dv/index.md b/hw/ip/kmac/dv/README.md
similarity index 100%
rename from hw/ip/kmac/doc/dv/index.md
rename to hw/ip/kmac/dv/README.md
diff --git a/hw/ip/kmac/doc/dv/tb.svg b/hw/ip/kmac/dv/doc/tb.svg
similarity index 100%
rename from hw/ip/kmac/doc/dv/tb.svg
rename to hw/ip/kmac/dv/doc/tb.svg
diff --git a/hw/ip/lc_ctrl/doc/_index.md b/hw/ip/lc_ctrl/README.md
similarity index 100%
rename from hw/ip/lc_ctrl/doc/_index.md
rename to hw/ip/lc_ctrl/README.md
diff --git a/hw/ip/lc_ctrl/doc/dv/index.md b/hw/ip/lc_ctrl/dv/README.md
similarity index 100%
rename from hw/ip/lc_ctrl/doc/dv/index.md
rename to hw/ip/lc_ctrl/dv/README.md
diff --git a/hw/ip/lc_ctrl/doc/dv/tb.svg b/hw/ip/lc_ctrl/dv/doc/tb.svg
similarity index 100%
rename from hw/ip/lc_ctrl/doc/dv/tb.svg
rename to hw/ip/lc_ctrl/dv/doc/tb.svg
diff --git a/hw/ip/otbn/doc/_index.md b/hw/ip/otbn/README.md
similarity index 100%
rename from hw/ip/otbn/doc/_index.md
rename to hw/ip/otbn/README.md
diff --git a/hw/ip/otbn/doc/dv/_index.md b/hw/ip/otbn/dv/README.md
similarity index 100%
rename from hw/ip/otbn/doc/dv/_index.md
rename to hw/ip/otbn/dv/README.md
diff --git a/hw/ip/otbn/doc/dv/fcov.md b/hw/ip/otbn/dv/doc/fcov.md
similarity index 100%
rename from hw/ip/otbn/doc/dv/fcov.md
rename to hw/ip/otbn/dv/doc/fcov.md
diff --git a/hw/ip/otbn/doc/dv/model.svg b/hw/ip/otbn/dv/doc/model.svg
similarity index 100%
rename from hw/ip/otbn/doc/dv/model.svg
rename to hw/ip/otbn/dv/doc/model.svg
diff --git a/hw/ip/otbn/doc/dv/tb.svg b/hw/ip/otbn/dv/doc/tb.svg
similarity index 100%
rename from hw/ip/otbn/doc/dv/tb.svg
rename to hw/ip/otbn/dv/doc/tb.svg
diff --git a/hw/ip/otp_ctrl/doc/_index.md b/hw/ip/otp_ctrl/README.md
similarity index 100%
rename from hw/ip/otp_ctrl/doc/_index.md
rename to hw/ip/otp_ctrl/README.md
diff --git a/hw/ip/otp_ctrl/doc/dv/index.md b/hw/ip/otp_ctrl/dv/README.md
similarity index 100%
rename from hw/ip/otp_ctrl/doc/dv/index.md
rename to hw/ip/otp_ctrl/dv/README.md
diff --git a/hw/ip/otp_ctrl/doc/dv/tb.svg b/hw/ip/otp_ctrl/dv/doc/tb.svg
similarity index 100%
rename from hw/ip/otp_ctrl/doc/dv/tb.svg
rename to hw/ip/otp_ctrl/dv/doc/tb.svg
diff --git a/hw/ip/pattgen/doc/_index.md b/hw/ip/pattgen/README.md
similarity index 100%
rename from hw/ip/pattgen/doc/_index.md
rename to hw/ip/pattgen/README.md
diff --git a/hw/ip/pattgen/doc/dv/index.md b/hw/ip/pattgen/dv/README.md
similarity index 100%
rename from hw/ip/pattgen/doc/dv/index.md
rename to hw/ip/pattgen/dv/README.md
diff --git a/hw/ip/pattgen/doc/dv/tb.svg b/hw/ip/pattgen/dv/doc/tb.svg
similarity index 100%
rename from hw/ip/pattgen/doc/dv/tb.svg
rename to hw/ip/pattgen/dv/doc/tb.svg
diff --git a/hw/ip/pinmux/doc/_index.md b/hw/ip/pinmux/README.md
similarity index 100%
rename from hw/ip/pinmux/doc/_index.md
rename to hw/ip/pinmux/README.md
diff --git a/hw/ip/pinmux/doc/dv/index.md b/hw/ip/pinmux/doc/dv/README.md
similarity index 100%
rename from hw/ip/pinmux/doc/dv/index.md
rename to hw/ip/pinmux/doc/dv/README.md
diff --git a/hw/ip/prim/doc/_index.md b/hw/ip/prim/README.md
similarity index 100%
rename from hw/ip/prim/doc/_index.md
rename to hw/ip/prim/README.md
diff --git a/hw/ip/pwm/doc/_index.md b/hw/ip/pwm/README.md
similarity index 100%
rename from hw/ip/pwm/doc/_index.md
rename to hw/ip/pwm/README.md
diff --git a/hw/ip/pwm/doc/dv/index.md b/hw/ip/pwm/dv/README.md
similarity index 100%
rename from hw/ip/pwm/doc/dv/index.md
rename to hw/ip/pwm/dv/README.md
diff --git a/hw/ip/pwm/doc/dv/tb.svg b/hw/ip/pwm/dv/doc/tb.svg
similarity index 100%
rename from hw/ip/pwm/doc/dv/tb.svg
rename to hw/ip/pwm/dv/doc/tb.svg
diff --git a/hw/ip/pwrmgr/doc/_index.md b/hw/ip/pwrmgr/README.md
similarity index 100%
rename from hw/ip/pwrmgr/doc/_index.md
rename to hw/ip/pwrmgr/README.md
diff --git a/hw/ip/pwrmgr/doc/dv/index.md b/hw/ip/pwrmgr/dv/README.md
similarity index 100%
rename from hw/ip/pwrmgr/doc/dv/index.md
rename to hw/ip/pwrmgr/dv/README.md
diff --git a/hw/ip/pwrmgr/doc/dv/tb.svg b/hw/ip/pwrmgr/dv/doc/tb.svg
similarity index 100%
rename from hw/ip/pwrmgr/doc/dv/tb.svg
rename to hw/ip/pwrmgr/dv/doc/tb.svg
diff --git a/hw/ip/rom_ctrl/doc/_index.md b/hw/ip/rom_ctrl/README.md
similarity index 100%
rename from hw/ip/rom_ctrl/doc/_index.md
rename to hw/ip/rom_ctrl/README.md
diff --git a/hw/ip/rom_ctrl/doc/dv/index.md b/hw/ip/rom_ctrl/dv/README.md
similarity index 100%
rename from hw/ip/rom_ctrl/doc/dv/index.md
rename to hw/ip/rom_ctrl/dv/README.md
diff --git a/hw/ip/rom_ctrl/doc/dv/tb.svg b/hw/ip/rom_ctrl/dv/doc/tb.svg
similarity index 100%
rename from hw/ip/rom_ctrl/doc/dv/tb.svg
rename to hw/ip/rom_ctrl/dv/doc/tb.svg
diff --git a/hw/ip/rstmgr/doc/_index.md b/hw/ip/rstmgr/README.md
similarity index 100%
rename from hw/ip/rstmgr/doc/_index.md
rename to hw/ip/rstmgr/README.md
diff --git a/hw/ip/rstmgr/doc/dv/index.md b/hw/ip/rstmgr/dv/README.md
similarity index 100%
rename from hw/ip/rstmgr/doc/dv/index.md
rename to hw/ip/rstmgr/dv/README.md
diff --git a/hw/ip/rstmgr/doc/dv/tb.svg b/hw/ip/rstmgr/dv/doc/tb.svg
similarity index 100%
rename from hw/ip/rstmgr/doc/dv/tb.svg
rename to hw/ip/rstmgr/dv/doc/tb.svg
diff --git a/hw/ip/rv_core_ibex/doc/_index.md b/hw/ip/rv_core_ibex/README.md
similarity index 100%
rename from hw/ip/rv_core_ibex/doc/_index.md
rename to hw/ip/rv_core_ibex/README.md
diff --git a/hw/ip/rv_core_ibex/doc/dv/_index.md b/hw/ip/rv_core_ibex/dv/README.md
similarity index 100%
rename from hw/ip/rv_core_ibex/doc/dv/_index.md
rename to hw/ip/rv_core_ibex/dv/README.md
diff --git a/hw/ip/rv_dm/doc/_index.md b/hw/ip/rv_dm/README.md
similarity index 100%
rename from hw/ip/rv_dm/doc/_index.md
rename to hw/ip/rv_dm/README.md
diff --git a/hw/ip/rv_dm/doc/dv/index.md b/hw/ip/rv_dm/dv/README.md
similarity index 100%
rename from hw/ip/rv_dm/doc/dv/index.md
rename to hw/ip/rv_dm/dv/README.md
diff --git a/hw/ip/rv_dm/doc/dv/tb.svg b/hw/ip/rv_dm/dv/doc/tb.svg
similarity index 100%
rename from hw/ip/rv_dm/doc/dv/tb.svg
rename to hw/ip/rv_dm/dv/doc/tb.svg
diff --git a/hw/ip/rv_timer/doc/_index.md b/hw/ip/rv_timer/README.md
similarity index 100%
rename from hw/ip/rv_timer/doc/_index.md
rename to hw/ip/rv_timer/README.md
diff --git a/hw/ip/rv_timer/doc/dv/index.md b/hw/ip/rv_timer/dv/README.md
similarity index 100%
rename from hw/ip/rv_timer/doc/dv/index.md
rename to hw/ip/rv_timer/dv/README.md
diff --git a/hw/ip/rv_timer/doc/dv/tb.svg b/hw/ip/rv_timer/dv/doc/tb.svg
similarity index 100%
rename from hw/ip/rv_timer/doc/dv/tb.svg
rename to hw/ip/rv_timer/dv/doc/tb.svg
diff --git a/hw/ip/spi_device/doc/_index.md b/hw/ip/spi_device/README.md
similarity index 100%
rename from hw/ip/spi_device/doc/_index.md
rename to hw/ip/spi_device/README.md
diff --git a/hw/ip/spi_device/doc/dv/index.md b/hw/ip/spi_device/dv/README.md
similarity index 100%
rename from hw/ip/spi_device/doc/dv/index.md
rename to hw/ip/spi_device/dv/README.md
diff --git a/hw/ip/spi_device/doc/dv/tb.svg b/hw/ip/spi_device/dv/doc/tb.svg
similarity index 100%
rename from hw/ip/spi_device/doc/dv/tb.svg
rename to hw/ip/spi_device/dv/doc/tb.svg
diff --git a/hw/ip/spi_host/doc/_index.md b/hw/ip/spi_host/README.md
similarity index 100%
rename from hw/ip/spi_host/doc/_index.md
rename to hw/ip/spi_host/README.md
diff --git a/hw/ip/spi_host/doc/dv/index.md b/hw/ip/spi_host/dv/README.md
similarity index 100%
rename from hw/ip/spi_host/doc/dv/index.md
rename to hw/ip/spi_host/dv/README.md
diff --git a/hw/ip/spi_host/doc/dv/tb.svg b/hw/ip/spi_host/dv/doc/tb.svg
similarity index 100%
rename from hw/ip/spi_host/doc/dv/tb.svg
rename to hw/ip/spi_host/dv/doc/tb.svg
diff --git a/hw/ip/sram_ctrl/doc/_index.md b/hw/ip/sram_ctrl/README.md
similarity index 100%
rename from hw/ip/sram_ctrl/doc/_index.md
rename to hw/ip/sram_ctrl/README.md
diff --git a/hw/ip/sram_ctrl/doc/dv/index.md b/hw/ip/sram_ctrl/dv/README.md
similarity index 100%
rename from hw/ip/sram_ctrl/doc/dv/index.md
rename to hw/ip/sram_ctrl/dv/README.md
diff --git a/hw/ip/sram_ctrl/doc/dv/tb.svg b/hw/ip/sram_ctrl/dv/doc/tb.svg
similarity index 100%
rename from hw/ip/sram_ctrl/doc/dv/tb.svg
rename to hw/ip/sram_ctrl/dv/doc/tb.svg
diff --git a/hw/ip/sysrst_ctrl/doc/_index.md b/hw/ip/sysrst_ctrl/README.md
similarity index 100%
rename from hw/ip/sysrst_ctrl/doc/_index.md
rename to hw/ip/sysrst_ctrl/README.md
diff --git a/hw/ip/sysrst_ctrl/doc/dv/index.md b/hw/ip/sysrst_ctrl/dv/README.md
similarity index 100%
rename from hw/ip/sysrst_ctrl/doc/dv/index.md
rename to hw/ip/sysrst_ctrl/dv/README.md
diff --git a/hw/ip/sysrst_ctrl/doc/dv/sysrst_ctrl_tb_block_diagram.svg b/hw/ip/sysrst_ctrl/dv/doc/sysrst_ctrl_tb_block_diagram.svg
similarity index 100%
rename from hw/ip/sysrst_ctrl/doc/dv/sysrst_ctrl_tb_block_diagram.svg
rename to hw/ip/sysrst_ctrl/dv/doc/sysrst_ctrl_tb_block_diagram.svg
diff --git a/hw/ip/tlul/doc/_index.md b/hw/ip/tlul/README.md
similarity index 100%
rename from hw/ip/tlul/doc/_index.md
rename to hw/ip/tlul/README.md
diff --git a/hw/ip/tlul/doc/dv/index.md b/hw/ip/tlul/doc/dv/README.md
similarity index 100%
rename from hw/ip/tlul/doc/dv/index.md
rename to hw/ip/tlul/doc/dv/README.md
diff --git a/hw/ip/uart/doc/_index.md b/hw/ip/uart/README.md
similarity index 100%
rename from hw/ip/uart/doc/_index.md
rename to hw/ip/uart/README.md
diff --git a/hw/ip/uart/doc/dv/index.md b/hw/ip/uart/dv/README.md
similarity index 100%
rename from hw/ip/uart/doc/dv/index.md
rename to hw/ip/uart/dv/README.md
diff --git a/hw/ip/uart/doc/dv/tb.svg b/hw/ip/uart/dv/doc/tb.svg
similarity index 100%
rename from hw/ip/uart/doc/dv/tb.svg
rename to hw/ip/uart/dv/doc/tb.svg
diff --git a/hw/ip/usbdev/doc/_index.md b/hw/ip/usbdev/README.md
similarity index 100%
rename from hw/ip/usbdev/doc/_index.md
rename to hw/ip/usbdev/README.md
diff --git a/hw/ip/usbdev/doc/dv/index.md b/hw/ip/usbdev/dv/README.md
similarity index 100%
rename from hw/ip/usbdev/doc/dv/index.md
rename to hw/ip/usbdev/dv/README.md
diff --git a/hw/ip_templates/alert_handler/doc/_index.md b/hw/ip_templates/alert_handler/README.md
similarity index 100%
rename from hw/ip_templates/alert_handler/doc/_index.md
rename to hw/ip_templates/alert_handler/README.md
diff --git a/hw/ip_templates/alert_handler/doc/dv/index.md b/hw/ip_templates/alert_handler/dv/README.md
similarity index 100%
rename from hw/ip_templates/alert_handler/doc/dv/index.md
rename to hw/ip_templates/alert_handler/dv/README.md
diff --git a/hw/ip_templates/alert_handler/doc/dv/tb.svg b/hw/ip_templates/alert_handler/dv/doc/tb.svg
similarity index 100%
rename from hw/ip_templates/alert_handler/doc/dv/tb.svg
rename to hw/ip_templates/alert_handler/dv/doc/tb.svg
diff --git a/hw/ip_templates/rv_plic/doc/_index.md b/hw/ip_templates/rv_plic/README.md
similarity index 100%
rename from hw/ip_templates/rv_plic/doc/_index.md
rename to hw/ip_templates/rv_plic/README.md
diff --git a/hw/ip_templates/rv_plic/doc/dv/index.md b/hw/ip_templates/rv_plic/doc/dv/README.md
similarity index 100%
rename from hw/ip_templates/rv_plic/doc/dv/index.md
rename to hw/ip_templates/rv_plic/doc/dv/README.md