diff --git a/addons/links/README.md b/addons/links/README.md
index 1f4b5346e446..c512695b275d 100644
--- a/addons/links/README.md
+++ b/addons/links/README.md
@@ -143,4 +143,4 @@ It accepts all the props the `a` element does, plus `story` and `kind`. It the `
 </LinkTo>
 ```
 
-To implement such a component for another framework, you need to add special handling for `click` event on native `a` element. See [`RoutedLink` sources](https://github.com/storybookjs/storybook/blob/main/addons/links/src/react/components/RoutedLink.js#L20-L24) for reference.
+To implement such a component for another framework, you need to add special handling for `click` event on native `a` element. See [`RoutedLink` sources](https://github.com/storybookjs/storybook/blob/main/addons/links/src/react/components/RoutedLink.tsx) for reference.
diff --git a/addons/links/src/react/components/RoutedLink.tsx b/addons/links/src/react/components/RoutedLink.tsx
index 2c5ede5f1d33..7fbf75157ba4 100644
--- a/addons/links/src/react/components/RoutedLink.tsx
+++ b/addons/links/src/react/components/RoutedLink.tsx
@@ -1,6 +1,6 @@
 import React from 'react';
 
-// NOTE: this is a copy of `lib/components/src/navigation/RoutedLink.js`.
+// NOTE: this is a copy of `lib/components/src/navigation/RoutedLink.tsx`.
 // It's duplicated here because that copy has an explicit dependency on
 // React 16.3+, which breaks older versions of React running in the preview.
 // The proper DRY solution is to create a new package that doesn't depend
diff --git a/lib/ui/README.md b/lib/ui/README.md
index c67276635788..9fff22f3c9fa 100644
--- a/lib/ui/README.md
+++ b/lib/ui/README.md
@@ -1,4 +1,4 @@
-# Storybook UI
+<h1>Storybook UI</h1>
 
 Storybook UI the core UI of [storybook](https://storybook.js.org).
 It's a React based UI which you can initialize with a function.
@@ -6,6 +6,7 @@ You can configure it by providing a provider API.
 
 ## Table of Contents
 
+- [Table of Contents](#table-of-contents)
 - [Usage](#usage)
 - [API](#api)
   - [.setOptions()](#setoptions)
@@ -20,6 +21,7 @@ You can configure it by providing a provider API.
   - [Core API](#core-api)
   - [Keyboard Shortcuts](#keyboard-shortcuts)
   - [URL Changes](#url-changes)
+  - [Story Order](#story-order)
 
 ## Usage
 
@@ -74,7 +76,7 @@ class ReactProvider extends Provider {
   handleAPI(api) {
     api.setOptions({
       // see available options in
-      // https://github.com/storybookjs/storybook/tree/main/addons/options#getting-started
+      // https://storybook.js.org/docs/react/configure/features-and-behavior
     });
   }
 }