Unfortunately you're right :( It's something we need to improve, and I agree the NUnit website is a good role model. It's very well done. It's a bit tricky as MbUnit is so tightly bound to Gallio, but Gallio is useful on it's own. However I'm sure we could make it clearer.
You have to bear in mind though, that the difference between our website and a bank's is that we do this for fun :) And writing documentation isn't. The wiki is vastly improved to a few months ago (mostly thanks to Yann's sterling efforts), and while we're aware we have a long way to go we are moving in the right direction. There is a lot of information available (the API docs are excellent) but we haven't done a very good job of making it easy for people to find, which is something for us to work on. Thank you for your comments Amit. On 9 August 2010 09:13, amitmor <[email protected]> wrote: > First, I don't want to be ungrateful, because I am very grateful for > MbUnit and I must say that I made a switch in the last couple of > months from Visual Studio's Testing Suite to MbUnit. > My motivation for switching is the great Data-driven aspects of MbUnit > (row, column, xml, csv input sources, etc.) and I enjoy it very very > much. > > However, I must agree with Ales regarding the lack of documentation. > Even worse, when you go through a 'serious' looking website and select > 'documentation' you expect something complete. Imagine going to your > online bank account and clicking the 'show me the balance' and you > find that it's under-construction. You just don't do it on websites. > It was very disappointing to find that the documentation it is > seriously lacking in MbUnit. This almost tilted the balance back > towards Visual Studio Testing back again. Luckily I found Jeff Brown's > 'bits in motion' which helped me reveal what MbUnit can do. > > IMHO, a good starting place for how MbUnit documentation should look > like is NUnit's documentation page. > For me, the most important thing is code examples, on the website, > with short annotations, before/after. > Another thing, when you go to http://gallio.org/Docs.aspx you have to > select the 'Gallio Wiki' to be able to see MbUnit doc. That's odd and > misleading. Why not specify that (a) the wiki is the most documented > place (b) gallio's wiki contains MbUnit documentation ? > > --Amit > > > On Aug 3, 8:54 am, Yann Trevin <[email protected]> wrote: > > Hi Ales, > > > > I'm afraid that you won't find any more complex documentation than in the > > wiki and the API doc. Or maybe in the Gallio source code itself :) > > > > What are the "interesting" topics you would like to read about? > > > > I'm currently preparing some articles about data-driven tests for the > wiki. > > Once I have finished, I could focus on them... > > > > Yann. > > > > 2010/8/2 Ales Vojacek <[email protected]> > > > > > > > > > Hi all, > > > is there some more complex documentation or samples for MbUnit and > Gallio? > > > I looked at gallio.org and in Gallio Book and Gallio wiki are only few > > > documents, more of interesting ones are "not written yet" . > > > Thank you A. > > > > > -- > > > You received this message because you are subscribed to the Google > Groups > > > "MbUnit.User" group. > > > To post to this group, send email to [email protected]. > > > To unsubscribe from this group, send email to > > > [email protected]<mbunituser%[email protected]> > <mbunituser%2bunsubscr...@googlegrou ps.com> > > > . > > > For more options, visit this group at > > >http://groups.google.com/group/mbunituser?hl=en. > > -- > You received this message because you are subscribed to the Google Groups > "MbUnit.User" group. > To post to this group, send email to [email protected]. > To unsubscribe from this group, send email to > [email protected]<mbunituser%[email protected]> > . > For more options, visit this group at > http://groups.google.com/group/mbunituser?hl=en. > > -- You received this message because you are subscribed to the Google Groups "MbUnit.User" 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/mbunituser?hl=en.
