Skip to content

Conversation

@franrob-projects
Copy link
Contributor

@franrob-projects franrob-projects commented Jan 21, 2026

Description

This PR adds the formatting to the VALs needed for the USB call outs. The USB call outs on other branches will be merged here.

I have added just one placeholder USP so that you can have a look. I will delete this in a future -- fixup once approved.

Checklist

@coderabbitai
Copy link

coderabbitai bot commented Jan 21, 2026

Important

Review skipped

Auto reviews are disabled on this repository.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@franrob-projects franrob-projects marked this pull request as ready for review January 21, 2026 17:31
@franrob-projects franrob-projects added the review-app Create a Heroku review app label Jan 21, 2026
@ably-ci ably-ci temporarily deployed to ably-docs-ftf-522-adds--tba6w9 January 21, 2026 17:31 Inactive
meta_description: "An introduction to Ably and its highly-available, scalable platform."
---

import { Banner } from '../../../components/blocks/banners'
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We shouldn't be using it like this. Have a look at how If component is included in the MDXWrapper, that way you don't need the import at the top of every file that uses the Banner.

https://github.com/ably/docs/blob/main/src/components/Layout/MDXWrapper.tsx

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cool.. I've added:

import { Banner } from '../blocks/banners';

to src/components/Layout/MDXWrapper.tsx

@GregHolmes
Copy link
Contributor

The test failed due to prettier:

/home/circleci/project/src/components/blocks/banners/Banner.tsx
  19:23  error  Insert `⏎`  prettier/prettier

/home/circleci/project/src/components/blocks/banners/index.tsx
  1:46  error  Insert `⏎`  prettier/prettier```

Your IDE should highlight these, if not, we can configure it with a plugin tomorrow.

@franrob-projects franrob-projects temporarily deployed to ably-docs-ftf-522-adds--tba6w9 January 22, 2026 09:41 Inactive
@franrob-projects franrob-projects had a problem deploying to ably-docs-ftf-522-adds--tba6w9 January 22, 2026 11:29 Failure
@franrob-projects franrob-projects temporarily deployed to ably-docs-ftf-522-adds--tba6w9 January 22, 2026 11:59 Inactive
Copy link
Contributor

@GregHolmes GregHolmes left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good! There are a couple of comments though.

The header of the Aside shouldn't be a header but instead slightly increased and boldened text.

The padding in the class of the Aside is too big compared to the design. I think once these changes are made it'll look clean on the page!

)}
>
<div className="flex-1 mt-1.5 mb-0.25">
{headline && <h3 className="ui-text-h3 font-bold text-neutral-1300 mb-3">{headline}</h3>}
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't think this is meant to be a header. From what I recall it was the same size as the text (or ever so slightly bigger than normal text) and boldened. H3 makes it stick out way too much on the page.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Font size of header text is 16 where normal text is 14.

{...rest}
data-type={dataType}
className={cn(
'border-l-[1.5px] px-6 pt-2.5 pb-1.5 my-6 rounded-r-lg w-full',
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Padding top is currently 0.625rem, which equates to 10px. The design's one is 8px for example.

I think looking at the Figma designs it should be more: 'border-l-[1.5px] px-6 py-2 my-6 rounded-r-lg w-full gap-1',

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

yeah impimented that and it looked way off

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I will re-do and see if shows any better but i did have to have a play around to make it look half decent

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

image

direct from design

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

alot more space at the bottom

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe it's because you've got the header as a header and not 16font size?

But screenshot below is from design. If the padding and styling is exactly as they've got in Figma, it'll look like this.

Screenshot 2026-01-22 at 13 37 45

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@GregHolmes

i've revered the others back...

but i've just reducd this:

'border-l-[1px] px-6 py-1 my-6 rounded-r-lg w-full gap-1',
image

its as close as i can get to the origianal

@franrob-projects franrob-projects temporarily deployed to ably-docs-ftf-522-adds--tba6w9 January 22, 2026 15:16 Inactive
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

review-app Create a Heroku review app

Development

Successfully merging this pull request may close these issues.

4 participants