On Wednesday, 8 February 2012 17:35:50 UTC, Iain Duncan wrote: > > I'll observe that's a straw man that you've brought to the party; no-one >> has mentioned any trimming of the docs, simplistically or otherwise. >> >
> That seems like a pretty clear mention of trimming the docs to get rid of > the 'esoteric' material to me. The esoteric material absolutely needs to > stay, IMHO. A lot of it what makes Pyramid great to advanced developers. It > should just be tucked away better somehow. > I stand corrected, thank you. I was nearing the end of a detailed broadly-in-agreement response when a stray key fumble caused Chrome to exercise ultimate editorial judgement by junking the lot (I'm learning to loathe Unity with a vengeance). So... broadly, yeah, what you and Mike wrote is more or less where I am atm. There was some early HCI work done on characterising users of computer help systems and this work plays into this situation fairly well. Users can be categorised on: i) frequency of interaction and ii) familiarity with the domain. Each dimension has 3-point nominal scale [low, medium, high], making a 3x3 grid. The results revealed that each combo produces its own set of user task requirements, some of which can be resolved merely by a shift of emphasis in the mode, some of which can only be resolved by a change of mode. It's not something that can be applied precisely, more of a frame for thinking about the issues but it works well with both your and Mike's posts combined. Nevertheless, Chris' post focused on intermediate developers, that's where he sees a relative weakness in the pedagogical support and that's where he sees part of the three months work going. I think his assessment is correct and I note the intended focus of resource expenditure. The primary mission is an improvement of the pedagogical effectiveness of the Pyramid documentation and there's no *a priori* reason why this shouldn't also be to the benefit of advanced developers. It is really useful to have this discussion - it's giving people an opportunity to influence the direction and result of the effort. Cheers, Graham. -- You received this message because you are subscribed to the Google Groups "pylons-discuss" group. To view this discussion on the web visit https://groups.google.com/d/msg/pylons-discuss/-/hGJgnKe-iaUJ. 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.
