doc: add GitHub star history

[trueNAHO]

Add the GitHub star history to illustrate the project's popularity and enhance its chances of wider adoption.

Reference:

• https://github.com/trueNAHO/dotfiles/commit/44fbb604ca88238091c1989614808b600cb412dd

Here is what the illustration looks like:

[trueNAHO]

this also appears in the documentation, where the color scheme doesn't perfectly match.

The default background color seems to be #0d1117.

Is there a transparent version of the image (possibly from another service) which we can use?

Apparently, such an option exists, but I cannot figure out how to use.

[pyrox0]

So, I know this isn't my project, and far be it from me to say how a project should advertise itself, but why? What use does this serve? How does it "enhance its chances of wider adoption", as you say? This doesn't seem to be useful. Yes, large projects use it, but correlation does not equal causation. If anything, I would say that star history graphs are used by large projects to show that they are popular, but don't help when a project is small(not that I think they help anyways)

[jalil-salame]

Is there a transparent version of the image (possibly from another service) which we can use?

Apparently, such an option exists, but I cannot figure out how to use.

Isn't it adding &transparent=true to the end of the URL.

Also, the URL looks weird:

// Upstream example
https://api.star-history.com/svg?repos=star-history/star-history&type=Date&theme=dark

// This PR
https://api.star-history.com/svg?repos=danth/stylix&theme=dark

// Expected URL
https://api.star-history.com/svg?repos=danth/stylix&theme=dark&transparent=true

[danth]

How does it "enhance its chances of wider adoption", as you say?

Presumably by showing the star count and how it has gradually increased over time, which demonstrates the longevity of the project.

Although they can be useful in some aspects, I would agree that a star chart could make it feel like the project exists for the primary purpose of gaining popularity, rather than providing code.

Also, the URL looks weird

This is HTML embedded in a Markdown document. As described in the HTML specification:

Authors should use & (ASCII decimal 38) instead of & to avoid confusion with the beginning of a character reference (entity reference open delimiter). Authors should also use & in attribute values since character references are allowed within CDATA attribute values.

[trueNAHO]

So, I know this isn't my project, and far be it from me to say how a project should advertise itself, but why? What use does this serve? How does it "enhance its chances of wider adoption", as you say? This doesn't seem to be useful. Yes, large projects use it, but correlation does not equal causation. If anything, I would say that star history graphs are used by large projects to show that they are popular, but don't help when a project is small(not that I think they help anyways)

How does it "enhance its chances of wider adoption", as you say?

Presumably by showing the star count and how it has gradually increased over time, which demonstrates the longevity of the project.

Although they can be useful in some aspects, I would agree that a star chart could make it feel like the project exists for the primary purpose of gaining popularity, rather than providing code.

Thanks for all the insightful comments. Frankly, I had not considered these popularity advertisement implications.

Upon discovering this tool, I simply thought it is interesting to see that the popularity of most popular projects increases exponentially rather than linearly:

This information might be more relevant in a pitch rather than the project itself. Feel free to close this PR.

[trueNAHO]

Is there a transparent version of the image (possibly from another service) which we can use?

Apparently, such an option exists, but I cannot figure out how to use.

Isn't it adding &transparent=true to the end of the URL.

IIRC, that did not work last time I tried it, although I may have used it incorrectly.

[trueNAHO]

So, I know this isn't my project, and far be it from me to say how a project should advertise itself, but why? What use does this serve? How does it "enhance its chances of wider adoption", as you say? This doesn't seem to be useful. Yes, large projects use it, but correlation does not equal causation. If anything, I would say that star history graphs are used by large projects to show that they are popular, but don't help when a project is small(not that I think they help anyways)

How does it "enhance its chances of wider adoption", as you say?

Presumably by showing the star count and how it has gradually increased over time, which demonstrates the longevity of the project. Although they can be useful in some aspects, I would agree that a star chart could make it feel like the project exists for the primary purpose of gaining popularity, rather than providing code.

Thanks for all the insightful comments. Frankly, I had not considered these popularity advertisement implications.

The "Factors contributing to daily stars" section might be interesting.

[trueNAHO]

Closing this PR based on https://github.com/danth/stylix/pull/312#issuecomment-2074981439.