In C++ it is common to call the setup_ui method from the constructor. Maybe you can do that in the tutorial as well. This also saves you one call when start the application (just calling w.show is enough, no need to call setup_ui since the constructor takes care of that).<br>
<br>I still have some small remarks about the markup. In my tutorial I put all references to code in a typewriter font. I believe this makes it a lot clearer to the reader when you're referring to code. I also put all commands in a '<code bash>' block. You can do that with the apt-get commands.<br>
<br>I think the tutorial looks nice and would make a great addition to the existing Techbase tutorials. If nobody else has any comments, I suggest you move it to an official location.<br><br>Niels<br><br><div class="gmail_quote">
2009/8/17 Declan McGrath <span dir="ltr"><<a href="mailto:declan@divilment.com">declan@divilment.com</a>></span><br><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
Thanks for the feedback Niels, that's great. I will look at implementing your suggestions soon and I'll post here when done.<br>
<br>
Also, can anyone advise as to whether overriding setup_ui() was the correct thing to do in order to add some items to the list - or is there a 'more correct' way of doing this?<br>
<br>
All the best,<br>
<font color="#888888">Declan<br>
</font><div><div></div><div class="h5"><br>
<br>
On Sunday 16 August 2009 17:33:12 Niels Slot wrote:<br>
> Hi Declan,<br>
><br>
> First of all, I'm not one of the QtRuby developers, nor a maintainer of<br>
> Techbase articles. I did wrote one of the Ruby tutorials for Plasma and have<br>
> 2 years of Ruby experience.<br>
><br>
> I looked through your tutorial. Basically, it looks nice. You tell the<br>
> reader how Qt Designer works and show sufficient code examples. The tutorial<br>
> is also very verbose, there's no way anyone could miss a step.<br>
><br>
> There are some small things that you could do to make it better:<br>
><br>
> - You can use the '<code ruby>' tags. This will enable Ruby highlighting for<br>
> snippets of code. There are also special tags for things like tips and<br>
> warnings.<br>
> - Please use 'Qt' not 'QT' when talking about the toolkit.<br>
> - You might want to think about your usage of bullets and numbers in the<br>
> lists. Try to separate the 'do this and that' from the explanation. In the<br>
> paragraph 'Creating the basic application structure' for example you have<br>
> 'run the rbuic4 command' and the explanation of its options on the same<br>
> level.<br>
> You could also, in general, put more of the text as normal text instead of<br>
> as lists.<br>
> - The tutorial could use an abstract. Possibly an introduction and maybe<br>
> some screenshots.<br>
><br>
> Great work, I look forward to your reply.<br>
><br>
> Niels<br>
><br>
> 2009/8/15 Declan McGrath <<a href="mailto:declan@divilment.com">declan@divilment.com</a>><br>
><br>
> > Hi folks,<br>
> ><br>
> > I'm just drafted a tutorial on developing Ruby apps with the QT Designer on<br>
> > Ubuntu at <a href="http://techbase.kde.org/User:Declan.mcgrath" target="_blank">http://techbase.kde.org/User:Declan.mcgrath</a><br>
> ><br>
> > If you think it might be useful for your techbase then please let me know<br>
> > with feedback and a location that I can move the page to.<br>
> ><br>
> > I'm new to using QT with the Ruby bindings so I've almost certainly gotten<br>
> > some things wrong but I think it would be useful to have an article that<br>
> > combines using Ruby and the QT Designer. I can't find any such articles. A<br>
> > quick googling of 'ruby qt' gave<br>
> ><br>
> > * <a href="http://www.darshancomputing.com/qt4-qtruby-tutorial" target="_blank">http://www.darshancomputing.com/qt4-qtruby-tutorial</a>             Doesn't<br>
> > mention using QT Designer<br>
> > * <a href="http://techbase.kde.org/Development/Languages/Ruby" target="_blank">http://techbase.kde.org/Development/Languages/Ruby</a>          Doesn't<br>
> > really explain the steps you'd go through with a new simple Ruby app<br>
> > starting with QT Designer - a lot of 'noise' for the newbie<br>
> > * <a href="http://www.kdevelop.org/doc/technotes/rubyrad.html" target="_blank">http://www.kdevelop.org/doc/technotes/rubyrad.html</a>              Out of<br>
> > date and KDE only<br>
> > * <a href="http://www.arachnoid.com/ruby/RubyGUIProject/" target="_blank">http://www.arachnoid.com/ruby/RubyGUIProject/</a>                       I<br>
> > found this the most useful. Still not simple enough and a bit out of date<br>
> ><br>
> > Kind regards,<br>
> > Declan<br>
> > _______________________________________________<br>
> > Kde-bindings mailing list<br>
> > <a href="mailto:Kde-bindings@kde.org">Kde-bindings@kde.org</a><br>
> > <a href="https://mail.kde.org/mailman/listinfo/kde-bindings" target="_blank">https://mail.kde.org/mailman/listinfo/kde-bindings</a><br>
> ><br>
><br>
<br>
</div></div></blockquote></div><br>