Thank you for your constructive comments, Amit. Graham said everything. Concerning your remark about the wiki, I made a few changes in the doc page of the website and in the wiki itself to emphasize the fact that MbUnit documentation might be found in the Gallio wiki. I believe that sometimes, we do not realize that people may have hard times to understand to deep relation between Gallio and MbUnit.
Regards, Yann. 2010/8/13 Graham Hay <[email protected]> > 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]<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.
