Show HN: manpages-tldr – short manpages with examples • Hacker News Board

blueblob wrote: post #5

It would be nice to have an example that is viewable from the markdown/on github. I think it would make people more likely to build it.

Do you mean screenshot of opened manpage?

Re: Show HN: manpages-tldr – short manpages with examples

#7

Post by andreasvc » Sun, Feb 02, 2014, 6:55 PM UTC

Why can't people just improve manpages so that they include a readable abstract and examples instead of coming up with projects with cute names?

Re: Show HN: manpages-tldr – short manpages with examples

#8

Post by [deleted] » Sun, Feb 02, 2014, 7:01 PM UTC

[deleted]

Re: Show HN: manpages-tldr – short manpages with examples

#9

Post by blueblob » Sun, Feb 02, 2014, 7:15 PM UTC

JIghtuse wrote: post #6

blueblob wrote: post #5

It would be nice to have an example that is viewable from the markdown/on github. I think it would make people more likely to build it.

Do you mean screenshot of opened manpage?

Yeah, that's one way. Or a similar text formatting on html/md on the readme. If you look at the bropages one, it very concretely shows you what it is. Any way of doing this makes it easier for people to tell what exactly they're getting.

Re: Show HN: manpages-tldr – short manpages with examples

#10

Post by jasonlotito » Sun, Feb 02, 2014, 7:33 PM UTC

andreasvc wrote: post #7

Why can't people just improve manpages so that they include a readable abstract and examples instead of coming up with projects with cute names?

So you think they should be "written as part of real manpages?"