diff --git a/mesh.proto b/mesh.proto
index dbbf813..f1cd5ef 100644
--- a/mesh.proto
+++ b/mesh.proto
@@ -409,7 +409,7 @@ message MeshPacket {
   /*
    * The sending node number.
    * Note: Our crypto implementation uses this field as well.
-   * See docs/software/crypto.md for details.
+   * See [crypto](/software/other/crypto.md) for details.
    * FIXME - really should be fixed32 instead, this encoding only hurts the ble link though.
    */
   fixed32 from = 1; 
@@ -432,7 +432,7 @@ message MeshPacket {
   uint32 channel = 3;
   
   /*
-   * Internally to the mesh radios we will route SubPackets encrypted per docs/software/crypto.md.
+   * Internally to the mesh radios we will route SubPackets encrypted per [this](/software/other/crypto.md).
    * However, when a particular node has the correct
    * key to decode a particular packet, it will decode the payload into a SubPacket protobuf structure.
    * Software outside of the device nodes will never encounter a packet where
@@ -453,7 +453,7 @@ message MeshPacket {
    * needs to be unique for a few minutes (long enough to last for the length of
    * any ACK or the completion of a mesh broadcast flood).
    * Note: Our crypto implementation uses this id as well.
-   * See docs/software/crypto.md for details.
+   * See [crypto](/software/other/crypto.md) for details.
    * FIXME - really should be fixed32 instead, this encoding only
    * hurts the ble link though.
    */
diff --git a/radioconfig.proto b/radioconfig.proto
index 72e32f8..fb2b866 100644
--- a/radioconfig.proto
+++ b/radioconfig.proto
@@ -141,7 +141,7 @@ enum LocationSharing {
 message RadioConfig {
 
   /*
-   * see sw-design.md for more information on these preferences
+   * see [software design](/software/other/sw-design.md) for more information on these preferences
    */
   message UserPreferences {
 
@@ -165,56 +165,56 @@ message RadioConfig {
      
     /*
      * Power management state machine option.
-     * See https://github.com/meshtastic/Meshtastic-device/blob/master/docs/software/power.md for details.
+     * See [power management](/software/other/power.md) for details.
      * 0 for default of 1 minute
      */
     uint32 wait_bluetooth_secs = 4;
     
     /*
      * Power management state machine option.
-     * See https://github.com/meshtastic/Meshtastic-device/blob/master/docs/software/power.md for details.
+     * See [power management](/software/other/power.md) for details.
      * 0 for default of one minute
      */
     uint32 screen_on_secs = 5;
     
     /*
      * Power management state machine option.
-     * See https://github.com/meshtastic/Meshtastic-device/blob/master/docs/software/power.md for details.
+     * See [power management](/software/other/power.md) for details.
      * 0 for default of 15 minutes
      */
     uint32 phone_timeout_secs = 6;
     
     /*
      * Power management state machine option.
-     * See https://github.com/meshtastic/Meshtastic-device/blob/master/docs/software/power.md for details.
+     * See [power management](/software/other/power.md) for details.
      * 0 for default of two hours, MAXUINT for disabled
      */
     uint32 phone_sds_timeout_sec = 7;
     
     /*
      * Power management state machine option.
-     * See https://github.com/meshtastic/Meshtastic-device/blob/master/docs/software/power.md for details.
+     * See [power management](/software/other/power.md) for details.
      * 0 for default of two hours, MAXUINT for disabled
      */
     uint32 mesh_sds_timeout_secs = 8;
     
     /*
      * Power management state machine option.
-     * See https://github.com/meshtastic/Meshtastic-device/blob/master/docs/software/power.md for details.
+     * See [power management](/software/other/power.md) for details.
      * 0 for default of one year
      */
     uint32 sds_secs = 9;
     
     /*
      * Power management state machine option.
-     * See https://github.com/meshtastic/Meshtastic-device/blob/master/docs/software/power.md for details.
+     * See [power management](/software/other/power.md) for details.
      * 0 for default of 3600
      */
     uint32 ls_secs = 10;
     
     /*
      * Power management state machine option.
-     * See https://github.com/meshtastic/Meshtastic-device/blob/master/docs/software/power.md for details.
+     * See [power management](/software/other/power.md) for details.
      * 0 for default of 10 seconds
      */
     uint32 min_wake_secs = 11;