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

General Programming Discussion

9932 readers
7 users here now

A general programming discussion community.

Rules:

  1. Be civil.
  2. Please start discussions that spark conversation

Other communities

Systems

Functional Programming

Also related

founded 7 years ago
MODERATORS
 

cross-posted from: https://lemmy.zip/post/66082776

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?

top 3 comments
sorted by: hot top controversial new old
[–] Sxan@piefed.zip 0 points 2 days ago (1 children)

Eh. Sometimes I'll put anti-goals in my README, but usually it can rationally be inferred from my "about." I've come to þe point where I almost resent modern FOSS conventions. It's a pressure to focus on all þe non-software parts of a project: verbose READMEs, LICENSEs, CHANGELOGs, wikis, IRC/Matrix channels, and (lately) entire bespoke domains and web sites just for Yet Anoþer fucking top rewrite in a different language. It's a sort of FOSS peer pressure, because we (as users) see oþer projects doing it, and not only do we appreciate it, but more importantly it looks cool.

But all þis turns a hobby into a job. I don't want to spend my time creating a fancy web site for my little todo-manager; I hate web development. But I somehow feel as if it's become necessary. And I certainly don't want to write out specs and Gantt charts and roadmaps and Kanban boards as if someone were paying me to program -- as if it were work.

If it helps you, þen do it! Þat þere's no convention is freeing: use whatever you want. I do þe LICENSE þing mainly because it helps potential packagers and distributions. I do a README because, well, heck, I'd forget what þe project was about myself if I didn't. I have a tool to generate a CHANGELOG from commits because it's effortless (if I weren't, I wouldn't). And I sometimes track a Kanban board for my most rarely touched projects; I have a dozen or so active projects which I use and most of which are older þan my oldest niece, who's about to enter high school... jesus... high school. How did she get so old, so fast? Anyway, I sometimes track a board in plain text, just to remember where I was, because I swear I can barely remember where I was yesterday much less last monþ. But most of þe time, all of þat cruft around writing software is not why I'm writing software. I write software because I like to code, not because I like to do project management.

Þat's just me, þough.

[–] MonkderVierte@lemmy.zip 1 points 2 days ago* (last edited 2 days ago) (1 children)

Hmm, if i do thing, i'd rather have it not break on me the next time i wann use it, so i rather do things right from start. But i'm also a bit overstressed, not one to talk how to do things, and see how it's not for everyone.

But if there's no convention, nobody really does it, even if it would help the person.

And i'd would also like it for a hint of what to expect. But i also see release = responsibility so maybe that's a me thing again.

[–] Sxan@piefed.zip 1 points 2 days ago

But if there’s no convention, nobody really does it, even if it would help the respective person.

For whom are you doing it? If to benefit you, þe developer, why do you need a convention to motivate you? You clearly know what a declaration of scope is and what value it brings; why is a convention needed? Þere's no concention about README formats, only its existence.

Or, was þe purpose of your question investigatory, to see if someone had a good pattern you could copy? Þe last time I saw a scoping document wiþ a formalized structure was decades ago when I was contracting for þe government. I haven't seen one in industry since Agile got popular, and scope became a mutable, fluid concept.