Ross, I did another big round of edits based on your responses to my questions.
--benson On Tue, Dec 8, 2009 at 9:26 AM, Ross Gardler <ross.gard...@googlemail.com> wrote: > 2009/12/8 Benson Margulies <bimargul...@gmail.com>: >> I just submitted my first set of edits here. I adopted a fairly >> high-handed attitude of rewriting to improve clarity -- according to >> my ideas of clarity. If you all find it to be a train wreck just roll >> it back and tell me what you don't like, and I'll try again. > > Thank you. "High handed" is good at this stage. I'll review your changes soon. > >> I did have some questions that came up where I'm not sure what was >> intended, either in document structure or in program(me) structure. >> >> Question 0: Program or Programme? I made it consistently Programme, >> though I wonder about using the British form in this one place in the >> entire ASF. > > I'm British, it would be nice to have something that's spelled right ;-) > > (honestly I don't have an opinion on this one). > >> Question 1: "How does the Mentor Programme work?" is an 'h1' with only >> a single 'h2' under it. Also, much of the content above it is, in >> fact, a quick summary of how the program works, and the 'Draft: the >> ASF Mentoring Programme' below it is the detailed description. Should >> this h1 be eliminated and the content below it all be promoted? > > +1 > >> Question 2: I am confused about the intended bootstrapping process. A >> would-be contributor shows up. To get started, that person needs to >> design a proposed project. That design process requires a mentor >> interaction. If the person already has a particular ASF project in >> mind, he or she could ask one of the identified mentors from that >> project for assistance. If the person does not have a particular ASF >> project in mind, then what? > > We will help them find their way? In reality we'd work with them to > find a suitable project to work on and hand hold them in their first > steps into that community. I see it as arranging to meet a shy friend > at the door to the party so they don't have to go in alone. > >> It seemed to me that there has to be some initial engagement between >> some generic mentor from the programme to help the new person navigate >> to the point of making contact with a specific project community. If >> that's the intention, I can write it to state that more clearly. > > I think tat's what I have in mind, so clarity there would be good. > >> Question 3: I don't understand the intention of "The mentee is >> expected to document guidance provided by the mentee within the >> appropriate documentation." What documentation would that be? > > Not sure (I'm reading out of context), but I think this is saying the > mentee has to help us write documentation for those who come later. > That is they help us write the mentor/mentee docs. > >> Question 4: Not all projects like incremental submissions. Some prefer >> proposed changes to mature for in a patch until complete. (e.g. >> Lucene). > > OK, we need to accommodate that then. > >> Question 5: The word 'project' is a big ambiguity problem. The entire >> ASF is organized as projects. So it is very hard to write this up to >> as to keep straight mentee projects and ASF projects without a lot of >> verbiage. If someone had another idea for what to call the mentee >> activities (activity? task? quest?) it would help. > > Yes, this has come up in GSoC and in conversation with a prospective > mentee over on the Wookie list. Activity and task is probably too fine > grained. Quest kind of works because it's a well known training > technique in the academic sector, is it so well known outside of that > sector? I'm afraid I have no other suggestions. > >> Question 6: Should the formal education material be on it's own page? >> Long confluence pages are hard to work with. > > +1, formal education part does not apply to all mentees. > > Ross > > > -- > Ross Gardler > > OSS Watch - supporting open source in education and research > http://www.oss-watch.ac.uk >