5 ms·
Whenever I see install instructions like this: OS X brew install cairo pkg-config go get github.com/ungerik/go-cairo Ubuntu sudo apt-get install libca
by philbarr 11y ago
Whenever I see install instructions like this:
OS X
brew install cairo pkg-config
go get github.com/ungerik/go-cairo
Ubuntu
sudo apt-get install libcairo2-dev pkg-config
go get github.com/ungerik/go-cairo
... I always think there should be a "default" instruction page linked to somewhere that explains what brew and apt-get are (and other things). I mean, I know you can't be expected to go to the lengths of explaining this stuff for every single project, but this is the kind of thing that will inspire the next generation. So maybe we, as a community could come up with a, "you don't know what this is? look here..." kind of page that people can put on their github projects.
- pradn 11y agoWholeheartedly agreed. When I was learning about OSS, I had no idea what a "pull request" was but people kept mentioning it. A standard guide on how OSS works with Github, Linux, and related tools would be immensely helpful in welcoming new developers into the OSS world.
- deleted 11y ago[deleted]
- pjc50 11y agoThe google answer for "what is a pull request" is quite good.
- totalart9000 11y agoWe already have something. It's called man pages. I say this kind of tongue-in-cheek but I'm also serious about it at the same time.
- soared 11y agoI completely agree. If you were linked to a github page out of the blue or for the first time its incredibly intimidating. Most notably is the first text you read on the page isn't a title, but a list of folders/files. Why not put the dam title and description at the top? One line of, "Hows this work?" would help a lot of people. I took the git lesson from code academy and have messed around in ubuntu but am still very intimidated by github and the brutal installation instructions every project has (or doesn't have).