Documentation

[SteveC]

Hi

I'm super excited about Rhodes but a bit perplexed by the
documentation. There are a couple of example apps like the SalesForce
app, but it just calls out to RhoSync for anything substantial. The
wiki is very, very thin and the screencasts don't seem to cover the
basics. The only option seems to be to go to a training day.

Have I missed something? It's such a super idea, and there's been a
ton of effort poured on to things like RhoHub and RhoSync, but there's
no bottom rungs of the ladder for a developer to figure this stuff
out.

Steve

[ad...@rhomobile.com]

Steve,

1) The "gentle introduction" to Rhodes is intended to be RhoHub.
RhoHub has an embedded tutorial here: http://wiki.rhomobile.com/index.php/RhoHub_Tutorial
2) There are several training videos around the usage of RhoHub and
Rhodes at http://youtube.com/rhomobile
3) If doing development "online" on RhoHub doesn't work for you there
is an "offline tutorial" (just using Rhodes and RhoSync on your own
machine without a hosted service) at http://wiki.rhomobile.com/index.php/RhoHub_Tutorial.
4) Full specifications for Rhodes are here: http://wiki.rhomobile.com/index.php/Rhodes.
Specs for RhoSync are here: http://wiki.rhomobile.com/index.php/RhoSync
5) There is an APress book on Rhodes and RhoSync in alpha form here:
http://www.apress.com/book/view/9781430228684. It should be out in
beta in the next month.

You (and others) are welcome to contribute to the wiki tutorials or
specs if you have additional content. Just register and we approve
all requests. There are already several third party contributions
there.

- Adam

[ad...@rhomobile.com]

Noticed that the link to the "offline" Rhodes tutorial was wrong and
it's now fixed below: http://wiki.rhomobile.com/index.php/Tutorial

Also the API samples project in github is a pretty helpful guide as
well: http://github.com/rhomobile/rhodes-system-api-samples

On Dec 28 2009, 11:33 pm, "a...@rhomobile.com" <a...@rhomobile.com>
wrote:

> Steve,
>
> 1) The "gentle introduction" to Rhodes is intended to be RhoHub.
> RhoHub has an embedded tutorial here:http://wiki.rhomobile.com/index.php/RhoHub_Tutorial
> 2) There are several training videos around the usage of RhoHub and

> Rhodes athttp://youtube.com/rhomobile

> 3) If doing development "online" on RhoHub doesn't work for you there
> is an "offline tutorial" (just using Rhodes and RhoSync on your own

> machine without a hosted service) athttp://wiki.rhomobile.com/index.php/Tutorial.

[d_nn_s]

I think Rhomobile is missing out on a lot of potential developers due
to lack of documentation.
Just like SteveC, I can't even get a grasp on how to start.
The biggest factor here is probably that most developers don't know
Ruby yet.
I myself included.

Even though I started reading up on Ruby and it seemed pretty cool, I
still couldn't put it to practice on RhoHub.
The Wiki tutorials are.... well.... completely uninteresting.
Perhaps it's the wikipedia style, perhaps it's the lack of
coordination and trying to explain too much in one tutorial, I don't
know.

The simple fact is that I don't even have a clue how to make an
application with two simple screens: one with "hello world" and a
button that links to the second screen.
And that should normally take you under an hour.

So in general there's very little reason to start using Rhomobile for
me.
I'd probably start developing in Objective C for the iPhone, because
there's more documentation on it.
It might be harder, but I bet I'll have an application ready in
Objective C before I finally understand RhoHub.

Anyway, it might be an idea to have a more newbie-proof tutorial that
explains how to write a really simple application.
One that also explains a little on Ruby, so people can make more sense
of it.

Regards,
~ Dennis.

p.s.: I have checked every tutorial you already linked.

On Dec 29 2009, 8:33 am, "a...@rhomobile.com" <a...@rhomobile.com>
wrote:

> Steve,
>
> 1) The "gentle introduction" to Rhodes is intended to be RhoHub.
> RhoHub has an embedded tutorial here:http://wiki.rhomobile.com/index.php/RhoHub_Tutorial
> 2) There are several training videos around the usage of RhoHub and

> Rhodes athttp://youtube.com/rhomobile

> 3) If doing development "online" on RhoHub doesn't work for you there
> is an "offline tutorial" (just using Rhodes and RhoSync on your own

> machine without a hosted service) athttp://wiki.rhomobile.com/index.php/RhoHub_Tutorial.

[Targino Silveira]

Hi Dennis, I agree with your e-mail content, RHomobile has a little documentation, I imagine that they are thinking that everyone knows Ruby ;-)

Ruby is not hard, it's more simple than to learn object-c and when you write an application on RHoHub you will write for others plataforms it's so better, I am still newbie on RHoMobile, but yesterday I was using for little time RHoHub and I saw that if you knows HTML, CSS, JavaScript, you can do much on the start, so is to start to learn how to do the blog in 15 minutes with RubyOnRails and you will understand so better..

I hope that others Ruby developers start with RhoMobile that will help many others developers with doubt about language.

Regards,

 

targino_silveira
{
:fone => +55-85-86267297,
:twitter => @targinosilveira / http://twitter.com/targinosilveira,
:recomende_me_como_um_profissional_ruby_on_rails =>
http://www.workingwithrails.com/person/17102-targino-silveira,

:yahoo_messenger => targino_...@yahoo.com.br,
:msn_messenger => targino...@ubbi.com.br
}

puts "A vida é um grande comércio, onde você recebe por aquilo que você paga."

---

De: d_nn_s <d.nn...@gmail.com>
Para: rhomobile <rhom...@googlegroups.com>
Enviadas: Quarta-feira, 6 de Janeiro de 2010 6:26:55
Assunto: [rhomobile] Re: Documentation

--
You received this message because you are subscribed to the Google Groups "rhomobile" group.
To post to this group, send email to rhom...@googlegroups.com.
To unsubscribe from this group, send email to rhomobile+unsub...@googlegroups.com.
For more options, visit this group at http://groups.google.com/group/rhomobile?hl=en.

---

Veja quais são os assuntos do momento no Yahoo! + Buscados: Top 10 - Celebridades - Música - Esportes

[Adam Blum]

The rhohub tutorial is intended to be completely self contained. As is
the apress book (you really read that?) The authors of both tutorials
read this group. They may consider adding to their tutorial your
example.

For what it's worth a page that links to another page should take a
few minutes to create and does not require Ruby at all, just HTML with
the first page being the app/index.erb page a either a hyperlink (or
form) referring to the second page.

Sent from my iPhone

> --
> You received this message because you are subscribed to the Google
> Groups "rhomobile" group.
> To post to this group, send email to rhom...@googlegroups.com.

> To unsubscribe from this group, send email to rhomobile+...@googlegroups.com

[d_nn_s]

The apress book is the only thing I haven't checked out, I simply
won't buy an expensive book for something I just want to try out.

Maybe I'm just a spoiled developer with high standards.
For example I love the Flash IDE, simply because it gives you the
freedom to place a component anywhere, with pixel-precision.
ActionScript isn't the most powerful language, but it gets the job
done.
I work with Eclipse and Netbeans too for several different programming
languages, all of which I learned from online free tutorials.
I'm a quick learner, which is why I'm kinda frustrated to why I still
can't operate RhoHub.

RhoHub is fairly new and lacks documentation from outsiders.
The current tutorial you say is completely self contained.
I don't agree, because it hasn't helped me start at all.
Perhaps again I'm too spoiled and need something more categorized or
with prettier looks.

The fact still remains that I'm probably going to wait until there are
other tutorials from the developing community before giving RhoHub
another try.
For now, I'm going to focus working with Steape (www.steape.com) that
promises the same things, but doesn't require you to learn Ruby.

I'm sorry if I seem a bit aggressive by the way, it's not my
intention.
I just wanted Rhomobile to be the answer to my "write once, run
anywhere" problem.

[Adam Blum]

The current tutorial was written by Sarah Allen, coauthor of the
APress book (which I highly recommend). She is enhancing the existing
tutorial (that I've seen people build
working apps from in less than an hour) based on some suggestions
here. I'm sure she would listen to your feedback if it was more
specific. Perhaps you two can start an offline dialog.

For what its worth, I get to talk to Rhodes and RhoHub customers all
day and see many of them building apps without knowing Ruby and
without even having read a tutorial. That said, as we focus on
features and reference materiel, we hope to see the community continue
to expand the breadth, depth and variety of tutorials.

For what it's worth we also won't attempt to teach people Ruby or
HTML. But the current Technical FAQ does contain links to appropriate
tutorials for those. You can also do quite a bit with a little ruby
knowledge. You will need HTML knowledge however to be successful with
Rhodes and rhohub

Sent from my iPhone

[Sarah Allen]

I agree that the tutorial is pretty limited in scope and it is written
for someone who knows Ruby (although the amount of code is small and
if you know ActionScript, you can probably follow it). It might be
useful to have a crib sheet for the non-rubyist, like... what's an
erb? what does <% ... %> mean and so forth.

I am planning to spend some more time adding to the tutorial and
welcome suggestions. However, if you are looking for an IDE with drag
and drop UI components, then documentation is not really the issue.

Sarah