this post was submitted on 13 Jun 2026
26 points (100.0% liked)

Programming

27261 readers
269 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 !webdev@programming.dev



founded 3 years ago
MODERATORS
 

I never see in public git projects something like a declaration of scope. There's also no convention, unlike a README.md (which rarely contains some sort of scope definition) or LICENSE file.

Is this unusual in open source projects, that you first define what you want and not want in your project and how you want to do it, to combat scope creep and sabotaging yourself?

I'm in a postition in live (short of a burnout) where it's actively a pain to just start things and then wing it; i even add a scope comment to larger shell scripts.
Maybe it's experience, because i already know that i'm then not satisfied afterward or (in case of shell scripts) just create a unfinished mess.

Nobody else? Or am i looking for the wrong term?

top 12 comments
sorted by: hot top controversial new old
[–] trem@lemmy.blahaj.zone 5 points 21 hours ago

Might also be a product of experience, that you have a need for strict scope definitions.

When I was unexperienced, I would actively look for projects I could do and features to add to them. Because well, most project ideas were too large for me to tackle anyways and I needed the experience.

Now that I have experience, I have multiple long-term projects that could use some love, if I find the time. And I have the experience to tackle virtually any project idea, if I find the time.

Don't particularly want to add another long-term project into the rotation, so I do spend a lot more time thinking upfront "when will this be finished?".

[–] hallettj@leminal.space 5 points 21 hours ago (1 children)

I haven't done this, but I think this idea is going to stick with me going forward

[–] MonkderVierte@lemmy.zip 4 points 12 hours ago

Great, i hope it helps you.

I'd also would love to see it more in the wild, as a kind of measure of what to expect.

[–] kubica@fedia.io 9 points 1 day ago (1 children)

Some projects include in the readme some mentions of goals and non-goals. And I also think it is pretty sane and transparent for both the mantainers and the users that these explanations exist.

[–] MonkderVierte@lemmy.zip 2 points 1 day ago

Yeah, but some do and it's not usual.

[–] somegeek@programming.dev 5 points 1 day ago (1 children)

As software engineers, an SRS doc is a very good friend of ours. just create a standard SRS doc and link to it in the readme.

I always start my projects with the SRS

[–] MonkderVierte@lemmy.zip 2 points 12 hours ago

Yeah, that looks interesting, thanks!

[–] CameronDev@programming.dev 5 points 1 day ago

I rarely even add readmes or licences, I like writing code, not polishing it.

[–] realbadat@programming.dev 3 points 1 day ago (1 children)

I always start with defining requirements, and then I follow with a bunch of pseudo code. Its how I do things at work too. I like getting the ideas and structure out before I write any actual code or I get stupidly distracted.

[–] MonkderVierte@lemmy.zip 2 points 1 day ago (1 children)

Same here. Just wondering why there is no format/convention for that, since we can't be the only ones.

[–] realbadat@programming.dev 3 points 1 day ago (1 children)

No, but maybe its an experience thing - have to be burned enough times by not having something to want to have something?

I think a lot of projects start off just someone goofing around with an idea so no hard requirements to start. I do that when I'm learning something new but they aren't ambitious or worth sharing.

[–] MonkderVierte@lemmy.zip 1 points 12 hours ago

Yeah but then i sit on the toilet and think "wait, then i would have to consider this and that" and then rather jot it down.