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.
