Bug 18237 - Issues and typos in the Calabash Query Syntax page
Summary: Issues and typos in the Calabash Query Syntax page
Alias: None
Product: Documentation
Classification: Xamarin
Component: Multi-Platform ()
Version: unspecified
Hardware: PC Mac OS
: --- normal
Target Milestone: ---
Assignee: Amy Burns
URL: http://docs.xamarin.com/guides/testcl...
Depends on:
Reported: 2014-03-06 21:17 UTC by Daniel Tavares
Modified: 2014-03-19 19:49 UTC (History)
1 user (show)

Is this bug a regression?: ---
Last known good build:

Notice (2018-05-24): bugzilla.xamarin.com is now in read-only mode.

Please join us on Visual Studio Developer Community and in the Xamarin and Mono organizations on GitHub to continue tracking issues. Bugzilla will remain available for reference in read-only mode. We will continue to work on open Bugzilla bugs, copy them to the new locations as needed for follow-up, and add the new items under Related Links.

Our sincere thanks to everyone who has contributed on this bug tracker over the years. Thanks also for your understanding as we make these adjustments and improvements for the future.

Please create a new report on Developer Community or GitHub with your current version information, steps to reproduce, and relevant error messages or log files if you are hitting an issue that looks similar to this resolved bug and you do not yet see a matching new report.

Related Links:

Description Daniel Tavares 2014-03-06 21:17:53 UTC
While reading the Calabash Query Syntax page I noticed the following:

1. Right at the top, the Android example suggest that I use a regular apk. I was only able to start the calabash-android console using the signed apk.
  "krukow:~/tmp/android$ calabash-android console login.apk"

2. This sentence is wrong: "Selects view objects whose that have a particular class..."
3. "determine" is misspelled in the following sentence: "These determines the direction..."
4. "equal" should be singular in "If they are equals values..."
5. "result like a integer" should be "...result like an integer..."
6. "...where row is an number..." should be "...where row is a number..."
7. For consistency you should say "boolean" instead of "BOOL"
8. Does Android not support entering text via keyboard? Similar to iOS with keyboard_enter_char and keyboard_enter_text? The article doesn't make it clear.
9. On the Visibility section, if "query_all" is deprecated, why mention it?
Comment 1 Amy Burns 2014-03-19 19:10:06 UTC
Fixes 2-9 have been addressed. Issue #1 is a Calabash problem. In theory, when you run calabash-android it should sign the APK for you. in practice, that sometimes doesn' happen (like when you're using jenkins), In that case, the only thing you can do about it is manually sign the APK as part of your CI, which is described in the CI docs.
Comment 2 Daniel Tavares 2014-03-19 19:49:05 UTC
Related to issue #1:

The problem I see is that the information on the example is inconsistent with what's in the "Run and Validate the Tests" section of the "Intro to Calabash" page[1].

That section makes it clear that you need a signed APK.

My suggestion is that you add an observation next to the Android example making it clear to the reader that he needs a signed APK.

[1] http://docs.xamarin.com/guides/testcloud/calabash/intro_to_calabash/