News for hackers. Stuff that matters.
Re:Gutenberg: Dynamic README generator with mixins for GitHub by matthiasv on Saturday October 19, 2013 @01:51PM (#6577163)
So, for the simplest tasks such as writing a README you need a Ruby gem these days? Or is it some satire which I didn't get yet?

(Just to clarify my position: I am all for automatizing daunting tasks as much as possible, but this seems to be a little far-fetched.)

Re:Gutenberg: Dynamic README generator with mixins for GitHub by sanderjd on Saturday October 19, 2013 @03:18PM (#6577442)
Well, no, nobody said you need a library to help you write your README, but if you get tired of writing the same structure or making the the same updates over and over again, you can use this to automate some of that process if you so desire. Seems pretty nifty to me, though I may well never use it.

I really don't understand the mindset that takes people from "hey look somebody wrote a free piece of software I can use if I want" to "what, now I need to use yet another piece of software for something?"

Re:Gutenberg: Dynamic README generator with mixins for GitHub by matthiasv on Saturday October 19, 2013 @06:45PM (#6578237)
> I really don't understand the mindset that takes people from "hey look somebody wrote a free piece of software I can use if I want" to "what, now I need to use yet another piece of software for something?"

It's not that I stop people from doing things they want to do. I just wanted to point out that something seemingly simple as writing a README usually does not require yet another tool that has to be learned and – being a dependency – maintained.

Re:Gutenberg: Dynamic README generator with mixins for GitHub by svoroval on Saturday October 19, 2013 @01:57PM (#6577189)
Not really far-fetched. Look at Sinatra README for example: https://github.com/sinatra/sinatra

There are 11 versions of Sinatra’s README which don’t share any general templates. They should be manually edited after each release. This is kind of thing that needs automatization.

Plus, it is much easier to inject badges by a mixin, not by copypasting and manually changing some elements from your old READMEs.

Re:Gutenberg: Dynamic README generator with mixins for GitHub by matthiasv on Saturday October 19, 2013 @06:40PM (#6578221)
Good point about those many versions. It's actually the first time that I've seen multiple READMEs in one project.
Re:Gutenberg: Dynamic README generator with mixins for GitHub by benaiah on Saturday October 19, 2013 @01:56PM (#6577183)
It doesn't seem to be useful so much as a way to make README writing easier, but rather as an easier and more modular way to keep it updated. This is important - stale docs are a PITA for anyone trying to use a library, and it's very easy to let them fall by the wayside.
Re:Gutenberg: Dynamic README generator with mixins for GitHub by svoroval on Saturday October 19, 2013 @01:58PM (#6577190)
Sure! You’ve got the idea.
Re:Gutenberg: Dynamic README generator with mixins for GitHub by ret on Saturday October 19, 2013 @02:01PM (#6577203)
I agree, but why not use existing program like M4.
Re:Gutenberg: Dynamic README generator with mixins for GitHub by svoroval on Saturday October 19, 2013 @02:09PM (#6577230)
Because it is not designed for this purpose?