search

danth / stylix

System-wide colorscheming and typography for NixOS
https://stylix.danth.me/
MIT License
906 stars 105 forks source link

doc: add GitHub star history #312

Closed trueNAHO closed 1 month ago

trueNAHO commented 3 months ago

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

Reference:

Here is what the illustration looks like:

Star History Chart
trueNAHO commented 3 months ago

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 commented 2 months ago

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 commented 2 months ago

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 commented 2 months ago

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 commented 2 months ago

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:

<img alt="Star History Chart" src="https://api.star-history.com/svg?repos=NixOS/nixpkgs,nix-community/home-manager,danth/stylix&Date&theme=dark" width="100%" />

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

trueNAHO commented 2 months ago

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 commented 2 months ago

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 commented 1 month ago

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