I've exchanged some interesting messages with Gary from Nafferton (NaffChap). He's been adding some footpaths through various parts of the local area. His questions have just reinforced the fact that the documentation for the project is letting us down. We use a wiki to document stuff, which seems to be the norm now, but I'm not convinced that it is a good idea. The very fact that anyone can edit it is great and awful at the same time. The wiki pages are all over the place, the language, tone and emphasis varies hugely. There are conflicting entries in a few places. I have created a few pages and maintained them, but most pages don't seem to have an owner so they either languish in slow decline or get hacked hither and thither by people with conflicting ideas or points of view.
I have tried to tidy some pages, but have given up because of adverse comments and conflicting revisions from other people. Some really useful features like relations are largely wasted, partly because the documentation bounces back and forth as to how to use them. People who know about how the wiki works just add complexity by sticking templates here, there and everywhere, which overloads the poor little server. They think this promotes consistency, but that comes from the text itself, not the layout.
The mailing lists are useful, though you need a thick skin to venture into osm-talk, but most users will only look in the wiki. SteveC has suggested a wiki cleanup day ( I think he probably had a wicked connected-world phrase for it) and that will be a good idea, but is a wiki really a good place for straightforward documentation - not in my book because sooner or later someone will screw it up.
Speaking of books , some people in Germany wrote an OSM book - I wonder how good that is at getting beginners started. The advantage of a book is that no-one can fiddle with it when it's published. The disadvantage is that it goes out of date, and quickly in world like ours.
I want OSM to succeed, and I'm sure it will, but it will do it better if beginners enjoy the process rather than fret over how to get started.
Gary has added some footpaths and that has just reinforced an idea that a walker's map for Easy Yorkshire will be a good idea. It is a lovely place to go for a walk and a good map always helps.