Clojurians Log v2

On my slack client I am seeing “? This file was not found.”

I deleted a previous version 🙂

@corasaurus-hex I think @martinklepsch 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

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.

Are those the contributors to the article or to the GitHub repo?

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 @corasaurus-hex 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

Hey Cora! 🤗 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 @martinklepsch, you certainly are trickling in the details on this one! 🙂 Best of luck with your product. ❤️

Haha yeah, I guess I could’ve shared a bit more context from the start 😅