bagder / uncurled

Uncurled - everything I know and learned about running and maintaining Open Source projects for three decades.

Uncurled

Uncurled – everything I know and learned about running and maintaining Open Source projects for three decades.

I have been actively involved in Open Source development since the early 1990s when I discovered the phenomenon of people writing source code they give away freely for others to use and modify under a certain license.

uncurled's Issues

Can't open 'Edit on GitHub' in other tab

Using Firefox on Linux I tried to open the link 'Edit on GitHub' (on this page, https://un.curl.dev/people/good-newcomers thought probably this is on every page) using Ctrl-click and/or right-click , but it keeps opening the GitHub page in the same tab.

Cover aspect ratio

Hi.
It is not a big deal but will be better if use portrait cover instead of current landscape version for epub cover.
Most of the ebook manager and ebook reader use that image in library(in portrait mod)

It was only a toy project so of course it was still Open Source.

That sentence in curl.md the seems to be a bit odd.

Many companies rather not say

In money/notsay.

One thing might be that they are afraid of the legal ramifications if someone gets hurt by the project or by the feature they sponsored. It is less likely that someone will sue an individual developer as they cannot expect any real compensation, but if there is a corporation with deep pockets is somehow associated with the project or with a specific feature then this can increase the risk of being sued despite the license on the project. Someone might even think they are entitled to support from the sponsoring company.

If you agree I can send this as a PR as well.

Title + domain

I need to decide on a title for this content so that I can setup a host/domain for the rendered web version. Until then, the rendered version is not made public and I do not market or mention this project much.

Open Source - How hard can it be? is the working title for now

Getting some Shivering on the main page when it loads

hey bro, great content there! I am just start digging there! that's an inspiration for me as newcomer. But the main page is giving some shivering effect when it loads, not sure what it is.

I am on kubuntu 21.04, running chrome 101.0.4951.54

Poor grammar / readability issues in review.md

This sentence is rather hard to parse and could use rephrasing:

uncurled/security/review.md

Lines 17 to 19 in 384afb5

	progress. We might consider getting that change merged into the code
	repository sooner to be more important and worth the risk, than waiting for a
	review that we do not want when or if it will happen.

---

This gets interpreted as a markdown list because the "-" is at the start of the line:

uncurled/security/review.md

Line 32 in 384afb5

- and avoid embarrassment.

---

uncurled/security/review.md

Lines 41 to 43 in 384afb5

	Scan your code with code analyzers and run your test suite with extra
	sanitizer tools to avoid memory leaks, undefined behaviors or other subtle
	problems to have sneaked in even if all (other) tests run fine.

Suggestion: s/to have/that may have/

---

These two sentences seem to be missing a predicate:

uncurled/security/review.md

Lines 49 to 54 in 384afb5

	Even when all of the steps above are successful, you can do more. For example,
	doing recurring tests that are run even if your code did not change at all to
	better cover when dependencies update over time and changes behavior.
	Fuzzing, which is a way to send garbage data to your APIs, to make sure that
	they endure such treatment properly. Fuzzing is typically a time-consuming job

My suggestion would be the following (but maybe you have a better idea of how you wanted to phrase this):

Even when all of the steps above are successful, you can do more:

• Run recurring tests even if your code did not change at all to catch issues when dependencies change behavior as they are updated over time.
• Implement fuzzing, which is a way to send garbage data to your APIs, to make sure that they endure such treatment properly.

---

I hope you don't mind the nit-picky issue. The book has been a great read for the most part, thanks for taking the time to write it!

How hard can it be?

How hard can it be?

Old versions never die

It would be nice if you extended it with example what you tell these people? in project/never-die.md

Text color: black

Hey, I'm excited to dig into this, as I'm in a very similar spot. Just one thing, maybe it's just me, in which case "C'est la vie", but it would be great if the text color would be black instead of .r-1nf4jbm { color: rgb(59, 69, 78); }, which looks slightly blurry to me.
Unsurpisingly, there isn't a consensus on what's "best": https://news.ycombinator.com/item?id=31420938
Best, Zenju

Offering Translation (Arabic Version)

Hi @bagder,

Are you open to offering a translation to this interesting work into other languages?

I offer to translate this interesting work to my native language (Arabic) and I don't have any problem reviewing and maintaining this translation. I am making this offer because I believe it will be beneficial to my community.

Hope to hear from you what you think.