Hey John,<br>The new HowTo section is the result of a offline conversation Thomas and I had. I noticed that the docs on master19 were shrinking, not growing. I wanted more of a Cookbook-style instructions, but Thomas had some really valid & good reasons why this is a bad idea for the official docs-- citing, among other things, <br>
<ul><li>difficulty in maintaining; <br></li><li>abandoned, out-of-date platform-specific instructions; <br></li><li>and people not bothering to understand what they're doing-- resulting a lot of time spent on newbies how barely understand the concept of how a web server works, trying to get an install working.</li>
</ul>The new docs are focused on "standalone", intended for everyone and small work-groups; and "server" intended for a very specific administrator-type audience.<br><br>Then, there's the new "HowTo" section (which was our idea of being a cookbook where we can add our own recipes (You and I must think alike, I even used the word "cookbook" when describing it). I've already moved over all the Windows-howto's that I've been maintaining. I fully encourage you to update/improve as you see fit.<br>
<br>Comments on your comments:<br><br>2. Features---<br> I agree that Moin kinda under-sells itself. At first glance doesn't looks as feature-full as Twiki and others (however, I switched from Twiki to Moin, which should tell you what I think of Twiki). The features page, in my opinion, should have more examples. Also, new features sometimes don't make it to the features page, like for example the <a href="http://moinmo.in/HelpOnAdmonitions">Admonitions</a>.<br>
<br>3. Comments/Discussion--<br> I too was baffled by the word-choice of Supplementation. I figured it was just a choice to not copy Wikipedia. Sorta like how every browser calls bookmarks; bookmarks. But Microsoft needed to differentiate and called theirs "favorites". :-) I think Moin could benefit be renaming it to 'Discussion'.<br>
<br>4. obsolete pages:<br> I second that. I'd love to aggressively go thru and delete all the 1.3-related stuff, for example. It's frustrating when I'm searching Moin and these antique pages come up. I would do it if I weren't afraid of getting banned. :-)<br>
<br><br>-Rick<br><br><br><br><div class="gmail_quote">On Fri, Jan 23, 2009 at 11:22 AM, John_Nowlan <span dir="ltr"><<a href="mailto:john_nowlan@carleton.ca">john_nowlan@carleton.ca</a>></span> wrote:<br><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
> <a href="http://moinmo.in/HowTo" target="_blank">http://moinmo.in/HowTo</a><br>
<br>
Should this be used for 'Cookbook/Recipes' and 'Tips'?<br>
<br>
I ask here because I am nervous about updating 'master' pages but will<br>
if it's agreed.<br>
<br>
Let me also say here that I'm impressed with the improvements being made<br>
to Moin. I just (finally) upgraded to Moin 1.8.1 under apache/mod_wsgi<br>
on windows and it performs better than expected!<br>
<br>
The improvements I'm talking about though are mostly to the<br>
documentation.<br>
It's been recognized as an area that needs work and each release it has<br>
gotten better imho.<br>
<br>
Thanks moin developers/contributors/users!<br>
<br>
Here are a few areas that still need work (and by saying this I am<br>
sayiing I will try and add/update docs - *gulp*, now I've done it,<br>
jumped into the fire/comitted to doing something) but may need help<br>
making sure I understand things.<br>
<br>
1. usage<br>
I'm always amazed at the way Moin can solve problems, but the answers<br>
have come from this list, not the docs.<br>
Specifically (and I'm going from memory, summarizing list discussion,<br>
some of these which I need to try, now that I'm able):<br>
- Paste from Word (when editing in GUI mode) as a way to convert html or<br>
word pages to wiki pages. Wins my best tip vote!<br>
- recent changes master page that shows changes from designated<br>
interwikis, acting as a master/department changes page for<br>
detail/subdepartments<br>
- others, but I'll try and address that in an actual howto page..<br>
<br>
2. features<br>
Moin often has the features, they just need to be discovered. This is<br>
unfortunate because others here at my work have been suggesting twiki,<br>
but I want to work in python :)<br>
The twiki front page is better from an eye candy perspective and<br>
highlighting its features than Moin. Maybe the features are more<br>
comprehensive? Twiki.net association/collaboration?<br>
<br>
3. notes/comments/discussion page -<br>
There is this page <a href="http://moinmo.in/HelpOnLinking/NotesLinks" target="_blank">http://moinmo.in/HelpOnLinking/NotesLinks</a>, but I<br>
don't understand it.<br>
Is this like (inline) comments? <a href="http://moinmo.in/HelpOnComments" target="_blank">http://moinmo.in/HelpOnComments</a><br>
Or <a href="http://moinmo.in/HelpOnConfiguration/SupplementationPage" target="_blank">http://moinmo.in/HelpOnConfiguration/SupplementationPage</a> and why<br>
isn't this called 'DiscussionPage' since this appears to be a better<br>
name, follows 'Wikipedia' which makes it more familiar, easier to<br>
understand, imho. Seriously, why 'Supplementation'? (o.k. I am a bigoted<br>
native english speaker:)<br>
<br>
Perhaps all these features need to discussed on one enveloping 'HowTo'<br>
page.<br>
<br>
4. out of date/obsolete stuff<br>
Universal to wiki's. Recognized.<br>
<br>
O.k., I've done enough complaining. Thanks for listening. Now maybe I<br>
can help...<br>
<div><div></div><div class="Wj3C7c"><br>
------------------------------------------------------------------------------<br>
This SF.net email is sponsored by:<br>
SourcForge Community<br>
SourceForge wants to tell your story.<br>
<a href="http://p.sf.net/sfu/sf-spreadtheword" target="_blank">http://p.sf.net/sfu/sf-spreadtheword</a><br>
_______________________________________________<br>
Moin-user mailing list<br>
<a href="mailto:Moin-user@lists.sourceforge.net">Moin-user@lists.sourceforge.net</a><br>
<a href="https://lists.sourceforge.net/lists/listinfo/moin-user" target="_blank">https://lists.sourceforge.net/lists/listinfo/moin-user</a><br>
</div></div></blockquote></div><br>