Skip to content

Conversation

@gewenyu99
Copy link
Contributor

What does this PR do?

Adds a new blog post about our new documentation!

Test Plan

Manual review.

@vercel
Copy link

vercel bot commented Oct 11, 2023

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name Status Preview Comments Updated (UTC)
website ✅ Ready (Inspect) Visit Preview 💬 Add feedback Oct 11, 2023 4:15pm


"Why don’t they read the docs?" We wanted to find out.

## Identifying the issues
Copy link
Contributor

Choose a reason for hiding this comment

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

We should only use # or ### to follow design. DW, we add a level to all headings to ensure no one uses a H1, since we auto-add it on the title. Meaning:

  • # -> <h2 />
  • ## -> <h3 />
  • ### -> <h4 />
    ...

Use # for headlines and ### for sub-headlines.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Used #


The new docs are written using an extended flavor of markdown made with [Markdoc and Svelte](https://github.com/TorstenDittmann/svelte-markdoc-preprocess), which makes community contributions easier. Markdown is easy to read and we can extend it with custom syntax like this multi-code selector.

``````
Copy link
Contributor

Choose a reason for hiding this comment

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

Why the ticks before the multicode?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Why the ticks before the multicode?

It shows the syntax, we don't actually want a multicore to be displayed.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Screenshot 2023-10-11 at 12 17 39 PM meant to show syntax

@gewenyu99 gewenyu99 requested a review from TGlide October 11, 2023 16:12
@gewenyu99 gewenyu99 merged commit 3680b14 into main Oct 11, 2023
@gewenyu99 gewenyu99 deleted the feat-docs-blog branch November 21, 2023 19:19
AbhiVarde pushed a commit to AbhiVarde/website that referenced this pull request Nov 11, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants