more docs updates

Author: ChristopherChudzicki

src/components/Button/ActionButton.stories.tsx

@@ -41,6 +41,9 @@ const EDGES = enumValues<NonNullable<ActionButtonProps["edge"]>>({
   none: true,
 })
 
+/**
+ * A button that should contain a remixicon icon and nothing else.
+ */
 const meta: Meta<typeof ActionButton> = {
   title: "smoot-design/ActionButton",
   component: ActionButton,
@@ -166,6 +169,13 @@ export const Showcase: Story = {
   ),
 }
 
+/**
+ * `ActionButtonLink` is styled as a `ActionButton` that renders an anchor tag.
+ *
+ * To use a custom link component (E.g. `Link` from `react-router` or `next/link`),
+ * pass it as the `Component` prop. Alternatively, customize the project-wide
+ * default link adapter via [Theme's LinkAdapter](../?path=/docs/smoot-design-themeprovider--docs)
+ */
 export const Links: Story = {
   render: () => (
     <Stack direction="row" gap={2} sx={{ my: 2 }}>

src/components/Button/Button.tsx

@@ -315,11 +315,11 @@ const ButtonInner: React.FC<
 type ButtonProps = ButtonStyleProps & React.ComponentProps<"button">
 
 /**
- * Our standard button component.
+ * Our standard button component. See [Button Docs](https://mitodl.github.io/smoot-design/?path=/docs/smoot-design-button--docs).
  *
  * See also:
- * - ButtonLink
- * - ActionButton
+ * - [ButtonLink](https://mitodl.github.io/smoot-design/?path=/docs/smoot-design-button--docs#links)
+ * - [ActionButton](https://mitodl.github.io/smoot-design/?path=/docs/smoot-design-actionbutton--docs) for icon-only uses
  */
 const Button = React.forwardRef<HTMLButtonElement, ButtonProps>(
   ({ children, ...props }, ref) => {
@@ -336,6 +336,9 @@ type ButtonLinkProps = ButtonStyleProps &
     Component?: React.ElementType
   } & LinkAdapterPropsOverrides
 
+/**
+ * See [ButtonLink docs](https://mitodl.github.io/smoot-design/?path=/docs/smoot-design-button--docs#links)
+ */
 const ButtonLink = React.forwardRef<HTMLAnchorElement, ButtonLinkProps>(
   ({ children, Component, ...props }: ButtonLinkProps, ref) => {
     return (
@@ -381,7 +384,11 @@ const actionStyles = (size: ButtonSize) => {
 
 /**
  * A button that should contain a remixicon icon and nothing else.
- * For a variant that functions as a link, see ActionButtonLink.
+ * See [ActionButton docs](https://mitodl.github.io/smoot-design/?path=/docs/smoot-design-actionbutton--docs).
+ *
+ * See also:
+ * - [ActionButtonLink](https://mitodl.github.io/smoot-design/?path=/docs/smoot-design-button--docs#links)
+ * - [Button](https://mitodl.github.io/smoot-design/?path=/docs/smoot-design-button--docs) for text buttons
  */
 const ActionButton = styled(
   React.forwardRef<HTMLButtonElement, ActionButtonProps>((props, ref) => (
@@ -401,6 +408,9 @@ type ActionButtonLinkProps = ActionButtonStyleProps &
     Component?: React.ElementType
   } & LinkAdapterPropsOverrides
 
+/**
+ * See [ActionButtonLink docs](https://mitodl.github.io/smoot-design/?path=/docs/smoot-design-actionbutton--docs#links)
+ */
 const ActionButtonLink = ActionButton.withComponent(
   ({ Component, ...props }: ButtonLinkProps) => {
     return <LinkStyled Component={Component} {...props} />

src/components/ThemeProvider/ThemeProvider.tsx

@@ -98,6 +98,12 @@ type ExtendedTheme = Theme & {
   custom: CustomTheme
 }
 
+/**
+ * Create a customized Smoot Design theme for use with `ThemeProvider`.
+ *
+ * See [ThemeProvider Docs](https://mitodl.github.io/smoot-design/?path=/docs/smoot-design-themeprovider--docs#further-customized-theme-with-createtheme)
+ * for more.
+ */
 const createTheme = (options?: {
   custom: Partial<ThemeOptions["custom"]>
 }): ExtendedTheme =>
@@ -116,6 +122,11 @@ type ThemeProviderProps = {
   theme?: Theme
 }
 
+/**
+ *
+ * @param param0
+ * @returns
+ */
 const ThemeProvider: React.FC<ThemeProviderProps> = ({
   children,
   theme = defaultTheme,