Skip to content

[docs] Improve social sharing of docs pages#34346

Merged
oliviertassinari merged 1 commit intomui:masterfrom
oliviertassinari:social-card-clarity
Sep 20, 2022
Merged

[docs] Improve social sharing of docs pages#34346
oliviertassinari merged 1 commit intomui:masterfrom
oliviertassinari:social-card-clarity

Conversation

@oliviertassinari
Copy link
Member

@oliviertassinari oliviertassinari commented Sep 17, 2022

Same rationale as #32536. When sharing a page to a specific docs page, the social image creates confusion https://twitter.com/olivtassinari/status/1571093885644046339.

Going forward, I think that we have two opportunities to improve, by increasing effort & outcome:

  1. Something like [blog] Remove default social card #32536 (comment), one very low distraction illustration, like "Material UI", one per product
  2. Something custom for each page https://www.notion.so/mui-org/Page-image-generator-75bc177fefe64c0b899a42a6f919a907

A bit related to #32181

@oliviertassinari oliviertassinari added the docs Improvements or additions to the documentation. label Sep 17, 2022
const card =
headers.card === 'true'
? `https://mui.com/static${router.pathname}/card.png`
? `https://mui.com/static/blog/${slug}/card.png`
Copy link
Member Author

@oliviertassinari oliviertassinari Sep 17, 2022

Choose a reason for hiding this comment

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

A small fix. It helps to search in the codebase for places were the images inside the blog folder are used.

@mui-bot
Copy link

mui-bot commented Sep 17, 2022

No bundle size changes

Generated by 🚫 dangerJS against a4e6d04

Copy link
Collaborator

@danilo-leal danilo-leal 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! I'd love to generate automatically the ones I've been manually doing for each blog post (see attachment)-we could then think about similar ones for doc pages.

Screen Shot 2022-09-19 at 23 50 02

@oliviertassinari
Copy link
Member Author

we could then think about similar ones for doc pages

Agree, a couple of options:

  • text as in this example
  • screenshot of a main demo of the page
  • screenshot of the component illustration on the page component cataloge (not built yet)

@oliviertassinari oliviertassinari merged commit 0638fff into mui:master Sep 20, 2022
@oliviertassinari oliviertassinari deleted the social-card-clarity branch September 20, 2022 07:11
alexfauquette pushed a commit to alexfauquette/material-ui that referenced this pull request Oct 14, 2022
daniel-rabe pushed a commit to daniel-rabe/material-ui that referenced this pull request Nov 29, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs Improvements or additions to the documentation.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants