Skip to content

Conversation

@tdunlap607
Copy link

After discussions with @catherinejones on the glibc-vs-musl.md documentation, I removed several portions of the doc and focused more on speed/compatibility.

The changes removed the buffer overflow, DNS issues (outdated), experimental warnings, and unsupported debug features. Old outdated references were pruned throughout the documentation as well.

Thank you @catherinejones for your thoughtful feedback. Please review at your convenience. Thank you!

cc @cartyc

@tdunlap607 tdunlap607 self-assigned this Jan 15, 2026
@tdunlap607 tdunlap607 requested a review from a team as a code owner January 15, 2026 20:18
@tdunlap607 tdunlap607 added the documentation Improvements or additions to documentation label Jan 15, 2026
@netlify
Copy link

netlify bot commented Jan 15, 2026

Deploy Preview for ornate-narwhal-088216 ready!

Name Link
🔨 Latest commit 178e8af
🔍 Latest deploy log https://app.netlify.com/projects/ornate-narwhal-088216/deploys/696a51539e1aa700085edd6a
😎 Deploy Preview https://deploy-preview-2902--ornate-narwhal-088216.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Copy link
Collaborator

@matthewhelmke matthewhelmke left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you for handling this update, @tdunlap607, based on the feedback from @catherinejones, who deserves a special shout out!

The deletions make sense and the changes are clear. So, LGTM and approved!


The *portability* of an application refers to its ability to run on various hardware or software environments without requiring significant modifications. Developers can encounter portability issues when moving an application from one libc implementation to another. That said, [Hyrum's Law](https://www.hyrumslaw.com/) reminds us that achieving perfect portability is tough. Even when you design an application to be portable, it might still unintentionally depend on certain quirks of the environment or libc implementation.

One common portability issue is the [smaller thread stack size](https://ariadne.space/2021/06/24/understanding-thread-stack-sizes-and.html) used by musl. musl has a default thread stack size of 128k. glibc has varying stack sizes which are determined based on the resource limit, but usually ends up being 2-10 MB.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Could I suggest keeping the ariadne.space links and moving them to a references section? I believe they’re effective at explaining why applications built for glibc have issues with musl

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I like that idea

Copy link
Contributor

@jspeed-meyers jspeed-meyers Jan 16, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

SGTM to me too! @tdunlap607: Could you please add in those links to a references section with a quick note that these links explain why applications built from glibc have issues with musl?

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good call :) added. Let me know if that works

Copy link
Collaborator

@matthewhelmke matthewhelmke left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I like the new section and retaining the discussed link in it. Thanks!

@jspeed-meyers jspeed-meyers self-requested a review January 16, 2026 14:59
Copy link
Contributor

@jspeed-meyers jspeed-meyers left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM. Thank you, @tdunlap607, for the PR and @catherinejones for the feedback and expertise.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants