I'd have to say I agree that it's a bit hard to find the right stuff googling right now. I'm guessing that's a matter of time, spiders finding links and so on, but whatever can be done to make it easier to find the right stuff for folks with a simple search would go a long way right now, IMHO.
iain On Tue, Mar 8, 2011 at 10:35 AM, Blaise Laflamme <[email protected]>wrote: > Hi David, > > thanks for your comments. Yeah the docs site was online far before the > real one and that's why everything seems to point to that direction. > You're right for having a better starting page for docs site and have > better back links. We'll try to work out something during pycon > sprints. > > On Mar 8, 10:58 am, David Eisner <[email protected]> wrote: > > On Tue, Mar 8, 2011 at 12:28 AM, mjmein <[email protected]> wrote: > > > I think the problem currently is that people start by going into the > > > main documentation, and then get overwhelmed. > > > > Yes. I have mentioned this elsewhere, but a newcomer like me goes > > through this process: > > > > 1. Google "Pyramid framework". > > The first hit ishttp://docs.pylonsproject.org. I've been told > > thathttp://pylonsproject.org/is meant to be the canonical starting > > page for Pyramid now, but that doesn't even show up on the first page > > of results. > > > > 2. Scan over the docs page and realize I'm already one level too deep. > > I want to get to a Pyramid overview page, which would probably > > include a link to the documentation page I'm now on. > > > > 3. Click "Pylons" on the orange banner at the top. > > Nope, that just takes me back to the page I'm already on. > > > > 4. Click on the "Home" navigation bread crumb. > > Also just takes me back to docs.pylonsproject.org > > > > 5. Hmm, I wonder what's atwww.pylonsproject.org. > > Aha! > > > > It shouldn't be this hard. The lack of a prominent link from > > docs.pylonsproject.org up to (www.)pylonsproject.org can be easily > > remedied. Tackling the Google results issue is a bit trickier. > > Perhaps it would help if the prominent "Pyramid" link onhttp:// > bfg.repoze.org/pointed tohttp://pylonsproject.org/and nothttp:// > docs.pylonsproject.org/projects/pyramid/dev/. More internal > > links back tohttp://pylonsproject.org/might also help. > > > > -David > > > > -- > > David Eisner http://cradle.brokenglass.com > > -- > You received this message because you are subscribed to the Google Groups > "pylons-discuss" group. > To post to this group, send email to [email protected]. > To unsubscribe from this group, send email to > [email protected]. > For more options, visit this group at > http://groups.google.com/group/pylons-discuss?hl=en. > > -- You received this message because you are subscribed to the Google Groups "pylons-discuss" group. To post to this group, send email to [email protected]. To unsubscribe from this group, send email to [email protected]. For more options, visit this group at http://groups.google.com/group/pylons-discuss?hl=en.
