Thank Lino rising this issue again. It has been discussed before, in my memory.
Dan has revised the whole docs structure recently. It's definitely a hard work. IMHO, maybe we need to consider a more easy-to-contribute- wiki-environment which can honor the contributors and allowing other's help to improve the page. For the help for beginners. I have two concerns: 1) I need big picture for explanations but I also need "real" examples to show how to write a working code; 2) I need a purpose-oriented beginner's guide. The point is "if you want to do this, you can use this, this, and this...and do it this way..." Dan has written a nice tutorial on how to built blog using BoltWire. It's a good example. http://boltwire.com/index.php?p=docs.extend.create_bf But in http://boltwire.com/index.php?p=docs page, it's difficult to find out. Oh, I think there could be a out-of-date button allowing contributors suggest not-yet-updated-pages or plugins. So the page can be tagged with a notice of "out-of-date" info and other users could be benefit from this notice and contributors can generate a list to find where to improve or update. Cheers, linly On 2月14日, 下午3時08分, Lino <[email protected]> wrote: > I've seen Linly's topic about transforming a form to a command and > feel a bit stupid. Or as using swiss army knife only for knocking on > door. > > The help system should include more "dumb user" oriented explanations > or even two different help trees, one for devs and other for users who > refuses to look under the hood. In both cases examples of use are > missing. > > Also, solutions should include help.solution.name and > devhelp.solution.name pages, written propely, the same as istalation > help - step by step. > > It is hughe job and not ment for one man, so I offer my help. > > B.r. > Lino --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "BoltWire" 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/boltwire?hl=en -~----------~----~----~----~------~----~------~--~---
