On Sun, Feb 15, 2009 at 9:55 PM, Linly <[email protected]> wrote: > > I think we can learn from http://en.wikipedia.org/wiki/ where there > are "featured article", "Did you know..." entries shown on the front > page. It's the problem that so many pages hide in the wiki and you > don't know where to find, how to start, and which page needing > improvement. > > So I suggest the BoltWire may consider some search (info) lists on the > main: > > 1) Most rated pages; > 2) Update needed pages; > 3) Most popular plugins; > 4) ...
We have had a family emergency this week that has kept me occupied. Which is why my posts have been less then frequent. But here are a few thoughts. 1) I appreciate the hesitancy to edit the docs pages, but that may just be a culture problem here, as the doc pages have been edit protected except by special permission. Now they are editable by anyone with an account. But I sense that needs to be combined with efforts to change the culture. Somehow we need to encourage contributions to the docs. I don't think realistically I will be able to provide the documentation BoltWire deserves because I lack time, and perhaps just as imortant, I don't use the docs. I read the code when I get stuck. So our best bet will probably be to transform our culture into something more open, and solicit contributions. However imperfect they may be. They don't have to be polished or perfect. Maybe some kind of syntax like: <box> Not sure about this but I think.... </box> This might encourage people to suggest content when not comfortable. Eventually these could be verified and added or deleted as needed. 2) To encourage development of the docs, I like the idea of some kind of rating/flagging system. I propose we have a box at the bottom at the bottom of each page with a simple check box to indicate whether or not a user found the doc page useful, and second a text box to suggest improvements to the page (with a few prompts, like questions not answered, inaccuracies, ambiguities, etc). The first would just be a running tally to give us some sense of the most helpful pages (just a total of the number of yes clicks, perhaps converted to some kind of 5 star rating). The second would be used to generate a search list called docs.help or something, which anyone could scan periodically, then edit pages they feel they can fix, and delete the suggestion. I'll try to get something up this week, but I'm finding myself short on time these days... But I'll probably do something along these lines. We could probably do the same things for the plugins as well. Feedback? Cheers, Dan --~--~---------~--~----~------------~-------~--~----~ 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 -~----------~----~----~----~------~----~------~--~---
