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

[Niels Slot]

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/20090816/21861294/attachment.html>