[DOC] update references
diff --git a/README.rst b/README.rst
index 41df290..c596ac6 100644
--- a/README.rst
+++ b/README.rst
@@ -18,18 +18,18 @@
    # SPDX-License-Identifier: Apache-2.0
    -->
 
-|License| |Documentation Status| |Build Status|
-
 CIIC Harness
 ============
 
+|License| |Documentation Status| |Build Status|
+
 A template SoC for Google SKY130 free shuttles. It is still WIP. The
 current SoC architecture is given below.
 
 .. raw:: html
 
    <p align="center">
-   <img src="/doc/ciic_harness.png" width="75%" height="75%">
+   <img src="/docs/source/_static/ciic_harness.png" width="75%" height="75%">
    </p>
 
 Datasheet and detailed documentation exists here:
@@ -39,7 +39,7 @@
 ----------------
 
 -  For information on tooling and versioning, please refer to
-   `this <mpw-one-b.md>`__.
+   `this <mpw-one-b.rst>`__.
 
 Start by cloning the repo and uncompressing the files.
 
@@ -214,7 +214,7 @@
 .. raw:: html
 
    <p align="center">
-   <img src="/doc/counter_32.png" width="50%" height="50%">
+   <img src="/docs/source/_static/counter_32.png" width="50%" height="50%">
    </p>
 
 The firmware running on the Management Area SoC, configures the I/O pads
diff --git a/info.yaml b/info.yaml
index 62f89c8..35806bf 100644
--- a/info.yaml
+++ b/info.yaml
@@ -16,4 +16,4 @@
   top_level_netlist: "verilog/gl/caravel.v"
   user_level_netlist: "verilog/gl/user_project_wrapper.v"
   version: "1.00"
-  cover_image: "doc/ciic_harness.png"
+  cover_image: "docs/source/_static/ciic_harness.png"