3 ms·

It'd be nice if these sort of links on github went to a nice friendly "What the hell is Ack?" page. With a nice summary of the project etc. Like in the big gree

by axod 17y ago

It'd be nice if these sort of links on github went to a nice friendly "What the hell is Ack?" page. With a nice summary of the project etc. Like in the big green "Sign up to github" box maybe? So people can see at a glance what the project is about. I know there's a README after some scrolling, but it's not really obvious. There's a load of hex strings which seem a bit premature, and a source list which again assumes I know what the project is all about... I kinda prefer how google code shows things :/ eg http://code.google.com/p/google-caja/ http://code.google.com/p/google-caja/

mgrouchy 17y ago
I could have always have pointed it at the actually readme http://github.com/petdance/ack/blob/master/README http://github.com/petdance/ack/blob/master/README I just thought in this case the root of the project might have made more sense. Maybe they should put an excerpt from the README under the standard project blurb with name, homepage and clone url.
- axod 17y ago
  That's not much better for me, still half a page of 'stuff' before the README starts :) I didn't mean to derail the thread though, but it's always irritated me about github links. I click on one and have no clue what the hell the project is. /me is off to checkout ack (Haven't used it before, and looks useful).
tvon 17y ago
It's a nice way of linking when you know what you're going to get but it's a lousy introduction to a project.
defunkt 17y ago
http://github.com/petdance/ack#readme http://github.com/petdance/ack#readme
masklinn 17y ago
You just scroll half a screen down and you get a nice > README > > ack is a grep-like tool tailored to working with large trees of source code. Github is about code first and foremost. So it makes sense to have the code up front and center. Projects who want doc on github will fill in the wiki and link to that instead of the tree.
juvenn 17y ago
http://betterthangrep.com http://betterthangrep.com

by axod 17y ago

mgrouchy 17y ago

I could have always have pointed it at the actually readme http://github.com/petdance/ack/blob/master/README http://github.com/petdance/ack/blob/master/README I just thought in this case the root of the project might have made more sense. Maybe they should put an excerpt from the README under the standard project blurb with name, homepage and clone url.

axod 17y ago
That's not much better for me, still half a page of 'stuff' before the README starts :) I didn't mean to derail the thread though, but it's always irritated me about github links. I click on one and have no clue what the hell the project is. /me is off to checkout ack (Haven't used it before, and looks useful).

tvon 17y ago

It's a nice way of linking when you know what you're going to get but it's a lousy introduction to a project.

defunkt 17y ago

http://github.com/petdance/ack#readme http://github.com/petdance/ack#readme

masklinn 17y ago

You just scroll half a screen down and you get a nice > README > > ack is a grep-like tool tailored to working with large trees of source code. Github is about code first and foremost. So it makes sense to have the code up front and center. Projects who want doc on github will fill in the wiki and link to that instead of the tree.

juvenn 17y ago

http://betterthangrep.com http://betterthangrep.com