this post was submitted on 14 Aug 2023
1207 points (97.9% liked)

Open Source

31359 readers
222 users here now

All about open source! Feel free to ask questions, and share news, and interesting stuff!

Useful Links

Rules

Related Communities

Community icon from opensource.org, but we are not affiliated with them.

founded 5 years ago
MODERATORS
 

I beg you, if you are a developer of an open source app or program - add screenshots of your app to the README file. When looking for the perfect app, I had to install dozens of them just to see what the user interface looked like and whether it suits me. This will allow users to decide if the app they choose will suit them... Please, don't think about it, just do it....

you are viewing a single comment's thread
view the rest of the comments
[–] [email protected] 100 points 1 year ago (2 children)

Sometimes I'd settled for a simple description of what the tool even is. Sometimes the readme is just straight into compilation steps and I feel like we're rushing into something.

[–] [email protected] 33 points 1 year ago* (last edited 1 year ago) (1 children)

Foreplay is important! Gotta get me excited for that app.

[–] [email protected] 18 points 1 year ago* (last edited 1 year ago)

🛠️ Building

To build the app install the gamete dependencies and run the following

make child
[–] [email protected] 13 points 1 year ago (1 children)

A lot of documentation is like that.

Its terrible when the software is called some random word that has nothing to do with the programs functionality

[–] kite 8 points 1 year ago (1 children)

I also hate it when it has a name that is a super common word or phrase. Our last 3 records management prograns at work have been like this, and their help fires are terrible to non existent. Good like trying to search the internet for information on the software with those common names. Even adding terms relevant to what the software does, didn't help much.

(Apologies if this is terribly typed, I've got an impending migraine aura that stayed right as I hit reply and have lost a good chunk of my vision. I can't see most of what I'm saying.)

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

Unrelated, but I used to get them often. I found one article about vitamin D deficiency as a potential cause, and figured, "what what hell". Started taking 5000IU every day of the Swanson's brand. It took a month or so, but I've been aura migraine free for months (still get migraines sometimes, but they're MUCH less severe than they used to be and no auras). Ask your doctor first, in case you can't take vitamin D, but it's worth a try if it's safe for you.

[–] kite 3 points 1 year ago (1 children)

I actually know what causes most of mine, there are some nerves in my neck that get pinched/aggravated and trigger them. And for some reason, if I have multiple days in a row where I don't get much sleep, those nerves get extra cranky. They are extra cranky right now.

[–] [email protected] 2 points 1 year ago

I'm so so sorry! I guess, at lease, you know why. That's something, right? Not really, but :shrug: seriously, I'm so sorry you're going through that!