[Kde-bindings] Can I put my 'Developing Ruby apps with the QT Designer' tutorial somewhere on KDE Techbase?

[Niels Slot]

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).

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.

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.

Niels

2009/8/17 Declan McGrath <declan at divilment.com>

> Thanks for the feedback Niels, that's great. I will look at implementing
> your suggestions soon and I'll post here when done.
>
> 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?
>
> All the best,
> Declan
>
>
> On Sunday 16 August 2009 17:33:12 Niels Slot wrote:
> > Hi Declan,
> >
> > First of all, I'm not one of the QtRuby developers, nor a maintainer of
> > Techbase articles. I did wrote one of the Ruby tutorials for Plasma and
> have
> > 2 years of Ruby experience.
> >
> > I looked through your tutorial. Basically, it looks nice. You tell the
> > reader how Qt Designer works and show sufficient code examples. The
> tutorial
> > is also very verbose, there's no way anyone could miss a step.
> >
> > There are some small things that you could do to make it better:
> >
> > - You can use the '<code ruby>' tags. This will enable Ruby highlighting
> for
> > snippets of code. There are also special tags for things like tips and
> > warnings.
> > - Please use 'Qt' not 'QT' when talking about the toolkit.
> > - You might want to think about your usage of bullets and numbers in the
> > lists. Try to separate the 'do this and that' from the explanation. In
> the
> > paragraph 'Creating the basic application structure' for example you have
> > 'run the rbuic4 command' and the explanation of its options on the same
> > level.
> > You could also, in general, put more of the text as normal text instead
> of
> > as lists.
> > - The tutorial could use an abstract. Possibly an introduction and maybe
> > some screenshots.
> >
> > Great work, I look forward to your reply.
> >
> > Niels
> >
> > 2009/8/15 Declan McGrath <declan at divilment.com>
> >
> > > Hi folks,
> > >
> > > I'm just drafted a tutorial on developing Ruby apps with the QT
> Designer on
> > > Ubuntu at http://techbase.kde.org/User:Declan.mcgrath
> > >
> > > If you think it might be useful for your techbase then please let me
> know
> > > with feedback and a location that I can move the page to.
> > >
> > > I'm new to using QT with the Ruby bindings so I've almost certainly
> gotten
> > > some things wrong but I think it would be useful to have an article
> that
> > > combines using Ruby and the QT Designer. I can't find any such
> articles. A
> > > quick googling of 'ruby qt' gave
> > >
> > > * http://www.darshancomputing.com/qt4-qtruby-tutorial
> Doesn't
> > > mention using QT Designer
> > > * http://techbase.kde.org/Development/Languages/Ruby          Doesn't
> > > really explain the steps you'd go through with a new simple Ruby app
> > > starting with QT Designer - a lot of 'noise' for the newbie
> > > * http://www.kdevelop.org/doc/technotes/rubyrad.html              Out
> of
> > > date and KDE only
> > > * http://www.arachnoid.com/ruby/RubyGUIProject/
> I
> > > found this the most useful. Still not simple enough and a bit out of
> date
> > >
> > > Kind regards,
> > > Declan
> > > _______________________________________________
> > > Kde-bindings mailing list
> > > Kde-bindings at kde.org
> > > https://mail.kde.org/mailman/listinfo/kde-bindings
> > >
> >
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.kde.org/pipermail/kde-bindings/attachments/20090819/e75fc3f1/attachment.html>