this post was submitted on 23 Nov 2023
124 points (97.0% liked)

Programming

17308 readers
98 users here now

Welcome to the main community in programming.dev! Feel free to post anything relating to programming here!

Cross posting is strongly encouraged in the instance. If you feel your post or another person's post makes sense in another community cross post into it.

Hope you enjoy the instance!

Rules

Rules

  • Follow the programming.dev instance rules
  • Keep content related to programming in some way
  • If you're posting long videos try to add in some form of tldr for those who don't want to watch videos

Wormhole

Follow the wormhole through a path of communities [email protected]

founded 1 year ago
MODERATORS
[email protected]
[email protected]
[email protected]
124
Is there a place where you can request code reviews on opensource software? (programming.dev)
submitted 11 months ago by [email protected] to c/[email protected]
36 comments fedilink hide all child comments
 

Many of us write opensource code in a void: nobody ever looks at it, uses it nor reviews it. We are the only users and authors.

In order to improve, where can we get our code reviewed? I don't mean professionally, just from like-minded individuals.

all 41 comments
sorted by: hot top controversial new old
[–] [email protected] 72 points 11 months ago (5 children)

This is not an answer to your question but it's tangentially related.

Someone I greatly respected ran an open-source project with the policy of merge everything. Completely flip this idea of carefully review, debate and revise every PR. His theory was that it helps to build an open community, and if something breaks someone else will revert that commit. He says that the main branch was almost always stable, a massive improvement to how it was run previously. He passed several years ago and for some reason this reminded me of him.

I guess what I'm trying to say is if you get something out there that people find useful, the code will be looked at. It doesn't help you if you're looking for someone to collaborate sorry.

[–] [email protected] 33 points 11 months ago (1 children)

This is how you get supply chain attacks.

[–] [email protected] 13 points 11 months ago

Yes it is. The code is in Bitcoin Core so there's a non-zero chance you win at life if you want to try.

[–] [email protected] 17 points 11 months ago* (last edited 11 months ago)

There is a very effective approach (34:00), that big companies like cloudflare use, to ship a product in a fast and quality way. It bears parallels to what you are describing. In essence engineers should not get hung up in the details to trying to solve everything.

  1. Just build a proof of concept
  2. Discard the prototype no matter what and start from scratch keeping the initial feedback in mind
  3. Build something internally that you yourself will use
  4. Only once something is good enough and is used internally, then release it to beta.

So that tedious process in trying to flush out all the details before seeing a product (or open source effort) working end to end, might be premature before having the full picture.

[–] [email protected] 11 points 11 months ago

That's Wikipedia's approach, arguably one of the most successful "open source" projects in history - certainly not without its problems, but overall it's pretty great

[–] [email protected] 4 points 11 months ago (1 children)

I've actually found his blog where he talks about this "optimistic merge"

http://hintjens.com/blog:106

[–] [email protected] 4 points 11 months ago (2 children)

There's a number of them as the idea grows. See also the C4 process RFC

[–] [email protected] 3 points 11 months ago

See also the C4 process RFC

What an unfortunate name.

https://c4model.com/

[–] [email protected] 2 points 11 months ago (1 children)

mbin (fork of kbin) is currently trying to implement the process.

[–] [email protected] 1 points 11 months ago (1 children)

It's great to see the attempt and also an example of what the C4 guidelines are made to avoid.

Notice how many comments are little nitpicks about this and that. Completely stalling the commit and getting further away from the original point of C4 which is to reduce contributor friction and avoid these kind of endless discussions on PRs.

I don't want to be too critical because some of that is a clear lack of understanding of the motivations of C4 which is explained more thoroughly in Pieter's blog posts. You don't want to adopt a contributor guidelines that you don't understand of course.

IMO it's better just to implement it as-is and start using it in practice rather than bikeshedding.

[–] [email protected] 2 points 11 months ago (1 children)

Feel free to make that comment there.

[–] [email protected] 2 points 11 months ago

I would have but I don't want to tie my Lemmy account to my actual identity :/

[–] [email protected] 3 points 11 months ago (1 children)

This is for 0mq right? I remember reading Pieter Hintjens about this realization he had over a long time of developing 0mq.

[–] [email protected] 7 points 11 months ago

Yes that's right. I was only just transitioning into adulthood and Pieter mentored me and profoundly changed how I view many things. It wasn't just zeromq but that was the main thing. I still keep his books at hand on my bookshelf. His death impacted me greatly.

[–] [email protected] 37 points 11 months ago (1 children)

Let's get a community going on programming.dev?

[–] [email protected] 32 points 11 months ago* (last edited 11 months ago) (2 children)

Just created a community request post for it https://programming.dev/post/6295144

If anyone is interested upvote the request and if anyone wants to mod it let me know

Edit: community has been made at [email protected]

[–] [email protected] 15 points 11 months ago (3 children)

Would love something like this, but it's very hard to get such a community working. Most of the time there will be way more people wanting a review of their code than people wanting to put in the work and review something.

Maybe some kind of point system could work. Like one needs to review at least two times before you can get your work reviewed.

[–] [email protected] 9 points 11 months ago (3 children)

One issue I can see with the points system is that people could just approve it with a "Looks good to me!" without even looking at the code. Or just looking at a small portion of the code.

[–] [email protected] 4 points 11 months ago

Also bike shedding. Simple stuff may get many people willing to review / argue about how you should have used A over B, or even C

Big / complicated projects - forget it. Especially if if they would need major refactoring.

[–] [email protected] 1 points 11 months ago

Yeah that's definitely a possibility. It's really a tricky topic to build a review community. One could try other approaches like dedicated volunteer reviewers. But if you look at exorcism, that will become hard to manage for languages with huge demand.

A system where everyone also needs to review is definitely better. Especially since everyone also learns reading other peoples code.

[–] [email protected] 1 points 11 months ago (1 children)

Could there be a way to award the points proportionally, based on how useful the feedback is?

[–] [email protected] 3 points 11 months ago

But who decides that? If the person who requested it can do this, you only need a friend to abuse the system and give each other a few extra points.

Maybe a open point history could help with this and users moderate themselves with this.

[–] [email protected] 3 points 11 months ago (2 children)

with that there would need some way for people to have things to initially review to get the community started. Could do something like after the first 3 posts the point system goes into effect

[–] [email protected] 2 points 11 months ago (1 children)

True, it's not a fleshed out idea haha. But starting with a few points would work.

Could actually be a cool in it self, wish I had time for something like that.

[–] [email protected] 1 points 11 months ago

Something like c sharp acedemy would be kinda cool. Basically do some beginner projects with good code reviews you get a "belt". That belt allows you to review the beginner projects as you work on intermediate projects. Then you complete those and get another belt that let's you do advanced projects and review the intermediate projects others submitted.

[–] [email protected] 1 points 11 months ago (2 children)

Kinda sounds like a format similar to Stack Exchange might work

[–] [email protected] 5 points 11 months ago

Just remove everything as a duplicate?

[–] [email protected] 2 points 11 months ago

There actually is a Stack Exchange community for code reviews: https://codereview.stackexchange.com/

[–] [email protected] 6 points 11 months ago

For those who wants to vote, ^^

[email protected]

[–] [email protected] 27 points 11 months ago

There is a Stack Exchange community for code reviews: https://codereview.stackexchange.com/

However they have some strict rules on what is allowed so it may not be suitable for open source projects. Two problematic ones are: 1) The poster must be the author/owner of the code. You, for example, can't post code that someone else has written. 2) All code that is to be reviewed must be included in the post. You can't just link to a repository.

[–] [email protected] 13 points 11 months ago

I would totally get in on that. Seems almost like a fun OS project itself. Like a volunteer hub type site to just seek reviews

[–] [email protected] 6 points 11 months ago* (last edited 11 months ago) (1 children)

There was something like that on Reddit but I can’t remember the sub. I haven’t seen one here. The best way to get reviews of open source is via contributions to larger projects. That of course doesn’t answer your question directly but is worth noting.

I’d recommend joining some discord or matrix servers for the language you work in or likeminded folk. They tend to have channels for that, and some have really helpful communities.

eta: I just checked my local instance and saw a community with very few subs and zero posts called /c/reviewmycode. Somebody has to post first.

[–] [email protected] 1 points 11 months ago

It is quite empty indeed 🤔 [email protected]

[–] [email protected] 5 points 11 months ago (1 children)

don't put us on the rack and post the link to the git

[–] [email protected] 16 points 11 months ago

It ain't near ready mate. Let me cook.

[–] [email protected] 1 points 11 months ago

Not exactly what you want, but plug-ins like sonarlint can nudge you in the right direction.