This page is not created by, affiliated with, or supported by Slack Technologies, Inc.
2024-02-29
Channels
- # announcements (6)
- # babashka (7)
- # beginners (24)
- # calva (2)
- # cider (21)
- # clj-kondo (49)
- # cljdoc (29)
- # clojure (56)
- # clojure-dev (2)
- # clojure-europe (15)
- # clojure-nl (6)
- # clojure-norway (27)
- # clojure-uk (3)
- # clojuredesign-podcast (6)
- # clojurescript (1)
- # conjure (1)
- # core-async (8)
- # cryogen (2)
- # cursive (6)
- # data-science (1)
- # datomic (12)
- # events (1)
- # fulcro (16)
- # graalvm (28)
- # hyperfiddle (2)
- # lambdaisland (4)
- # leiningen (20)
- # observability (1)
- # off-topic (24)
- # pathom (5)
- # pedestal (10)
- # portal (7)
- # practicalli (1)
- # reitit (5)
- # rewrite-clj (20)
- # shadow-cljs (18)
- # vim (8)
- # xtdb (9)
I'm thinking of adding dynamic opengraph images to cljdoc (via an external service), do you think something like the below would be useful in link previews? Am I missing any information we could/should display?
on documentation we could display the number of contributors?
Sorry haven’t had my first coffee yet! 🙂 I’m not clear yet where this is displayed. Is seems like the cljdoc home page but I see reitit?
ah sorry! So this would be the image that gets autoexpanded in a lot of contexts like Slack, Twitter, etc, whenever a URL is shared. In this case it would be ~for this URL https://cljdoc.org/d/metosin/reitit/0.7.0-alpha7/doc/introduction
Ooooh! I see, tx. So the new info is the contributors count. And the formatting is new. And... the pom description is no longer included.
What does GitHub do? Lessee (for comparison): https://github.com/metosin/reitit/blob/master/doc/README.md
Hmm... nada. Let's try: https://github.com/metosin/reitit
So, I'm not saying we should not make this change, but I am also not sure I see yet the rationale for it. Is it to better promote cljdoc? To look more polished? To more clearly summarize a link?
What does clojars do? Lessee: https://clojars.org/metosin/reitit-core/versions/0.7.0-alpha7
I like clojars summary. I honestly also think the current cljdoc summary is pretty good.
This is what I see clojars doing, it's not really showing an image at all: https://www.opengraph.xyz/url/https%3A%2F%2Fclojars.org%2Fmetosin%2Freitit-core%2Fversions%2F0.7.0-alpha7
cljdoc is currently not showing an image at all: https://www.opengraph.xyz/url/https%3A%2F%2Fcljdoc.org%2Fd%2Fmetosin%2Freitit%2F0.7.0-alpha7%2Fdoc%2Fintroduction
so what I'm suggesting, and maybe this wasn't perfectly clear, is adding OpenGraph images to these urls so that apps like Slack, Telegram, Twitter, Facebook etc. can provider a more rich link preview
So on Slack, things look good to me today. I personally don’t use other social media, but I do understand your rationale for this change now. I’m probably not a great person to give feedback on this one! ❤️ Maybe @U02N27RK69K would have some input?
it's a good thing to do, especially for on twitter where they JUST show that image now and not the title or description. I know sites are pretty aggressive about caching so the images probably won't be as dynamic as you might expect
but i'd be in favor of this change if someone wanted to make it
@U02N27RK69K I think @U050TNB9F was looking for feedback on content and maybe (?) styling.
oh, duh, ok!
I think adding the contributors is a good idea, and maybe github stars if we can get it, and maybe link to the source code like how github's expanded text links to the project's website.
I don't think I have much to add about the styling outside of adding a generic image. you could embed info in the image but if we do we should make sure it doesn't include more info than is present in the text, keeping things accessible is important
I've done this all of one time and probably wouldn't be helpful on the technical front
Hey Cora! :hugging_face: Thanks for your thoughts, any feedback is great really. I was just trying to figure out if it would add value to cljdoc users. As it happens I'm working on a project (dare I say, product) that makes this kind of image generation trivial from an engineering perspective and I'm looking for more places where I can get some real-world testing 🙂 I'll have a look and open a PR some time (might take a week until I get to it so don't hold your breath please ❤️ )
Here's a sneak peek: https://dynogee.com/preview?project-name=metosin%2Freitit&project-version=0.7.0-alpha3&page-title=Introduction&id=0oxzd1u4ol4nrwz&contributors=6%20contributors
Holy smokes @U050TNB9F, you certainly are trickling in the details on this one! 🙂 Best of luck with your product. ❤️