Conversation
|
unicorn |
|
Hi @Mo-way, thanks for reviving the Zig list! I've reviewed your PR and the zigcc/awesome-zig repository. This is a very high-quality submission, but I have some suggestions to make the content "Awesome-standard" perfect. all these are my personal opnions and not a compulsory TODO list. your PR a already a very strong. Content & Structure Advice:
"Misc": Awesome lists try to avoid "Misc" or "General" categories. Try to find specific homes for these items or add tags to these so people can easily understand there purpose (e.g., "Data Structures", "Config", "Build Tools", "zig migration").
Consistency: Some descriptions are very short ("JSON5 parser") while others are sentences. Standardizing them to "Noun - Description." makes the list much more readable. Great work organizing the community replacement for the old list! 🚀 |
bad-antics
left a comment
There was a problem hiding this comment.
Great to see Zig back in the main awesome list! The zigcc community maintains this well (2k stars). This replaces the previous unmaintained list. Well-documented PR explaining the history. LGTM.
|
Any luck with this patch? I have refactored it to make it more readable:
|
|
@sindresorhus Any chance for a review? Feedback was addressed. With this PR #3735 would be fixed, not only closed. |
suryakantamangaraj
left a comment
There was a problem hiding this comment.
Hey! I took a look at this. The link and CC0 license are all set, but you should probably tweak the repo description.
Right now it says 'A collection of awesome projects in Zig.' Sindre usually prefers the description to define the subject (Zig itself) rather than the 'list.'
Maybe change it to something like: 'General-purpose programming language and toolchain for maintaining robust, optimal, and reusable software.'
Once that's updated, it looks good to go!
|
Hi @suryakantamangaraj good catch. The description at top of Readme already is like you ask. Looking at other awesome lists, the "about" section is normally smth like "curated list of...". |
|
I have updated the description to this:
Let me know if there are any improvements. |
|
looks cool to me now |
Insufficient reviews
1 clear qualifying review out of 2 required. Entry not at the bottom of the categoryThe entry is placed between V (line 265) and Move (line 266), but the last entry in the Programming Languages section is F# (line 269). The guideline requires placement "at the bottom of the appropriate category." Linked list issues"Misc" sectionThe "Misc" section has only 2 entries and uses a vague name. Consider merging these into a more descriptive section or removing them if they don't fit anywhere. "TOC is generated by markdown-toc" textThe line |
|
appreciate the info
…On Wed, Apr 1, 2026 at 1:35 PM Sindre Sorhus ***@***.***> wrote:
*sindresorhus* left a comment (sindresorhus/awesome#3859)
<#3859?email_source=notifications&email_token=B4CX3ZZ6NAOXLDMBDLPVYID4TULIXA5CNFSNUABFM5UWIORPF5TWS5BNNB2WEL2JONZXKZKDN5WW2ZLOOQXTIMJXGAYDKMRSG4Z2M4TFMFZW63VKON2WE43DOJUWEZLEUVSXMZLOOS2XA4S7MNXW23LFNZ2F633QMVXF6Y3MNFRWW#issuecomment-4170052273>
Insufficient reviews
PR What you did Counts?
#3529 <#3529> (NativeScript) Title
contains "Awesome", questioned placement, Plugin/Component sections mostly
link to main repo Yes
#3536 <#3536> "Please stop
spamming." (identified a spam PR) No -- calling out spam is not a
guideline-based review of a list
#3732 <#3732> (DynamoDB) Called
out AI-generated reviews by another user Borderline -- meta-commentary on
review quality, not a review of the list itself
1 clear qualifying review out of 2 required.
Entry not at the bottom of the category
The entry is placed between V (line 265) and Move (line 266), but the last
entry in the Programming Languages section is F# (line 269). The guideline
requires placement "at the bottom of the appropriate category."
------------------------------
Linked list issues "Misc" section
The "Misc" section has only 2 entries and uses a vague name. Consider
merging these into a more descriptive section or removing them if they
don't fit anywhere.
"TOC is generated by markdown-toc" text
The line TOC is generated by markdown-toc after the Contents section is
meta-information that doesn't belong in the main content. Remove it or move
it to a Footnotes section.
—
Reply to this email directly, view it on GitHub
<#3859?email_source=notifications&email_token=B4CX3ZZ6NAOXLDMBDLPVYID4TULIXA5CNFSNUABFM5UWIORPF5TWS5BNNB2WEL2JONZXKZKDN5WW2ZLOOQXTIMJXGAYDKMRSG4Z2M4TFMFZW63VKON2WE43DOJUWEZLEUVSXMZLOOS2XA4S7MNXW23LFNZ2F633QMVXF6Y3MNFRWW#issuecomment-4170052273>,
or unsubscribe
<https://github.com/notifications/unsubscribe-auth/B4CX3Z6VWEJK5OLAXJ3FS4L4TULIXAVCNFSM6AAAAACQ5HMCO6VHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHM2DCNZQGA2TEMRXGM>
.
You are receiving this because you are subscribed to this thread.Message
ID: ***@***.***>
|
|
Both |
|
Added another review (even though I'd say that calling out spam PRs saves maintainer effort as well, advancing the goal "make the project self suffieient") |
|
Some additional considerations:
|
PR review said that end of list is better than using the original position.
|
nice to see zig back after the last one got delisted, and awesome-but-inactive.md is a real answer to why the previous list got pulled. paste that context into the PR description or reviewers miss it the IMPORTANT callout about compiler versions at the top kind of breaks the header → description → TOC flow. zig moves fast I get it, but wouldnt it make more sense per-entry where version matters, or as a footnote at the bottom? Linker looks like a 1-item subcategory. fold into Tooling or add a second entry also the current description update (A collaborative list of awesome Zig libraries and resources) still describes the list not zig. @suryakantamangaraj already flagged this, the new wording didnt fix it. needs to describe the language |
https://github.com/zigcc/awesome-zig
Zig is a general-purpose programming language and toolchain for maintaining robust, optimal and reusable software.
The previous Zig list went un-maintained. It was removed in fa5128c.
As suggested in issue #3735, this PR adds the Zig list maintained by zigcc community.
See zigcc/awesome-zig#167 for more information.
PRs reviewed:
By submitting this pull request I confirm I've read and complied with the below requirements 🖖
Please read it multiple times. I spent a lot of time on these guidelines and most people miss a lot.
Requirements for your pull request
Try to prioritize unreviewed PRs, but you can also add more comments to reviewed PRs. Go through the below list when reviewing. This requirement is meant to help make the Awesome project self-sustaining. Comment here which PRs you reviewed. You're expected to put a good effort into this and to be thorough. Look at previous PR reviews for inspiration. Just commenting “looks good” or simply marking the pull request as approved does not count! You have to actually point out mistakes or improvement suggestions. Comments pointing out lint violation are allowed, but does not count as a review.
Add Name of List. It should not contain the wordAwesome.Add SwiftAdd Software ArchitectureUpdate readme.mdAdd Awesome SwiftAdd swiftadd SwiftAdding SwiftAdded Swift- [iOS](…) - Mobile operating system for Apple phones and tablets.- [Framer](…) - Prototyping interactive UI designs.- [iOS](…) - Resources and tools for iOS development.- [Framer](…)- [Framer](…) - prototyping interactive UI designs#readme.- [Software Architecture](https://github.com/simskij/awesome-software-architecture#readme) - The discipline of designing and building software.Requirements for your Awesome list
That means 30 days from either the first real commit or when it was open-sourced. Whatever is most recent.
awesome-linton your list and fix the reported issues. If there are false-positives or things that cannot/shouldn't be fixed, please report it.main, notmaster.Mobile operating system for Apple phones and tablets.Prototyping interactive UI designs.Resources and tools for iOS development.Awesome Framer packages and tools.If you have not put in considerable effort into your list, your pull request will be immediately closed.
awesome-name-of-list.awesome-swiftawesome-web-typographyawesome-SwiftAwesomeWebTypography# Awesome Name of List.# Awesome Swift# Awesome Web Typography# awesome-swift# AwesomeSwiftawesome-list&awesomeas GitHub topics. I encourage you to add more relevant topics.Awesome Xand a logo withAwesome X. You can put the header image in a#(Markdown header) or<h1>.Contents, notTable of Contents.ContributingorFootnotessections.https://github.com/<user>/<repo>/community/license/new?branch=main&template=cc0-1.0(replace<user>and<repo>accordingly).licenseorLICENSEin the repo root with the license text.Licencesection to the readme. GitHub already shows the license name and link to the full text at the top of the repo.unicorn.contributing.md. The casing is up to you.Contributing, positioned at the top or bottom of the main content.Footnotessection at the bottom of the readme. The section should not be present in the Table of Contents.Example:
- [AVA](…) - JavaScript test runner.Node.js, notNodeJSornode.js.You can still use a CI for linting, but the badge has no value in the readme.
Inspired by awesome-fooorInspired by the Awesome projectkinda link at the top of the readme. The Awesome badge is enough.Go to the top and read it again.