We have moved to a new Sailfish OS Forum. Please start new discussions there.

What's missing in the user guide?

asked 2014-01-10 18:41:43 +0300

lbt gravatar image

updated 2014-07-22 13:24:53 +0300

jiit gravatar image

We have a great user guide:


but it's not always 100% accurate or complete.

So, if you see anything that needs fixing - please tell us here

Some guidelines:

  • We don't want to expand it a great deal - it's not supposed to be an exhaustive description of every aspect of the device
  • We do want to include particularly useful things and clarify any confusion
  • Changes in updates which got missed in the guide are useful
  • Focus is mainly on the content - we're fixing things like the missing "Go Top" button and device CSS


edit retag flag offensive close delete


Should we post suggestions as separate answers so as to make it more clear that they refer to different sections / topics of the guide? This way also the comments and discussions would stay more organized.

foss4ever ( 2014-01-10 21:36:49 +0300 )edit

@jjaone - Good point(s)!
E.g.: If someone's suggestion could be better formed by someone else, or if other persons disagree on a certain suggestion, etc..

I've converted my comment to an "Answer".

phle ( 2014-01-10 23:04:18 +0300 )edit

@phle Cool ;)

foss4ever ( 2014-01-10 23:08:38 +0300 )edit

28 Answers

Sort by » oldest newest most voted

answered 2014-01-11 20:38:39 +0300

simosagi gravatar image

I'd like to see as last page a printable PDF 'cheat sheet' (one page A4 or perhaps a two-sides A5) with a list of all icons/symbols used by Sailfish, maybe the tree view of the settings menu, the table with notification led signaling, and other similar synthetic information.

edit flag offensive delete publish link more


This isn't in scope at the minute. Sounds like a good community project though :)

r3d ( 2014-01-17 12:49:12 +0300 )edit

answered 2014-01-10 20:31:56 +0300

phle gravatar image

regarding "hide keyboard"
In the Messages section, the Treasure saying
"Pulling down on the keyboard will also send it away."
is a bit confusing: what is sent away - the message, or the keyboard?

I suggest moving that Treasure to the keyboard section instead - e.g. to the section Common tasksOn-screen keyboard, placed right before Copy and paste - and re-written as, or similar to
"You can hide the keyboard by pulling down anywere on the keyboard's main character area."

(I read the User Guide prior to receiving my Jolla, and therefore couldn't try things as I read it.
I didn't know there was a gesture for hiding the keyboard, until I read that tip when casually mentioned somewhere else.
Yeah, I know, I should probably spend some time re-reading the User Guide now, Jolla in hand. ;-) )

edit flag offensive delete publish link more



Is this really supposed to work? I tried the gesture at firsy, with no results, and I tbought it was not implemented. I tried this again after reading the answer above, and I could actually close the keyboard... only I cannot perform the actikn reliably... it works for me once in four or so.

mikelima ( 2014-01-10 23:42:39 +0300 )edit

@mikelima - For me, it works every time, but
I need to pull over two rows on the on-screen keyboard, and
it doesn't work if I start at, say, the period or the comma, i.e. just one row, and
it doesn't work if I start up in the word prediction area (hence the "on the keyboard's main character area" part).

Also: Note that - as opposed to the pulley menu pull - the keyboard doesn't move until your finger has crossed two on-screen keyboard character rows (e.g. English: pull from top row's RTY, to middle row's FG).

Hope That Helped!

phle ( 2014-01-11 00:01:43 +0300 )edit

@mikelima It doesn't work, if you hit the prediction bar. Try hitting some key and swipe down.

But I think it needs some training to get this gesture work. Even if I hit a key, it doesn't work each time.

szobi ( 2014-01-11 00:05:22 +0300 )edit

@szobi, @mikelima - (and not really hitting the keys - think "same movement as with the pulley menu up top", but down over the keyboard area)

phle ( 2014-01-11 00:12:30 +0300 )edit

I should read the manual better.. this a good one, works for me

teun ( 2014-01-17 16:33:03 +0300 )edit

answered 2014-10-13 01:56:53 +0300

axaq gravatar image

Please provide the user gide as installable package in the Jolla store as the available Tutorial. I would like to have an offline version of the user guide available on the phone.

edit flag offensive delete publish link more


Am wondering why not just have a PDF file available by default in Documents folder? Documents also will not be empty as it is now. ;-)

anandrkris ( 2014-10-29 15:31:09 +0300 )edit

answered 2014-01-11 20:17:24 +0300

Mohjive gravatar image

The dot and number indicating tethering should be explained now that there are applications that makes tethering available from a GUI.

edit flag offensive delete publish link more


Yes! I was a bit puzzled when I first saw it, but assumed it had to do with the tethering (even though I didn't really figure out the "1").
Just saw "What does dot and number beside connection icon mean?", though.

The weird thing is that even if I had the dot-and-number before, it's now gone.
(I was going to check whether the "1" changed to a "2" if I connected two devices, or not.)

phle ( 2014-01-11 22:22:25 +0300 )edit

Thanks for this. We've updated the guide to give a mention to tethering.

r3d ( 2014-01-29 15:08:36 +0300 )edit

answered 2014-01-11 01:14:54 +0300

ssahla gravatar image

updated 2014-01-11 01:17:07 +0300

Under common tasks > copy and paste, there's this treasure: "Double-tap, then drag within the document to zoom in - this lets you choose your cursor position more carefully. "

First, I'm not sure it's in the right place. I find it very useful when editing text I've written / correcting typos, but that has nothing to do with copy and paste. Maybe it should be under on-screen keyboard. Secondly, the description of the feature is not quite accurate: You don't need a double-tap, just a drag from the cursor position; and it has to be a drag left or right, not vertically (I don't know which is wrong, the documentation or the implementation, but anyway, they don't match :).

edit flag offensive delete publish link more



That feature is tricky to achieve - I've only accidentally done it a couple of times in the Events view's "Share what's on your mind", but used the Jolla app "Notes" to practise some, in a multi-row wall of text.

I think I got the hang of it - it's a quick movement, more of the "tap-tapdrag" variety than a "double-tap, then drag" (the second tap just smoothes out into a drag movement), and with some practice I manage to achieve it about 4 times out of 5.

hm I tried your "no double-tap, just drag left-or-right from cursor" - this one is easier, and is the one I've accidentally done before (the one I mentioned in the first paragraph), but must start on the cursor (and then only drag "sideways", just as you wrote)
Press ever so slightly on cursor, don't lift your finger, and then drag the cursor along the row. Once magnified, you can then move the cursor around, including up and down to other rows (as long as you don't lift your finger, of course).

Aha ... I think I get it:
The first tap locates the cursor under your finger, the second "tap" is actually your press-and-drag movement, and I may then drag the cursor in whatever direction I like to - but if I pause too long between the first tap and the second tap/press-drag, then the magnifier only appears if I drag sideways.
(As a matter of fact, once I got the hang of it, I could actually stretch the pause a bit ... but it really requires some practice, and it's easily forgotten, and then I'm back to practising again ... )

(Sorry for the train of thoughts, I wrote it while practising, so I hope it makes sense ... )

It is under "On-screen keyboard", and I guess it's hard to find a more suitable place (especially with my suggestion of moving another Treasure found under Messaging to On-screen keyboard as well). Copy/paste are, after all, parts of editing.

So: I guess it's in the right place after all, and somewhat accurately described. It could have a better description, but I'm unsure of how to clarify/improve it without being lengthy (I mean: just look at my wall of text above!).

phle ( 2014-01-11 12:13:25 +0300 )edit

Okay, you're right: "copy and paste" is under "on-screen keyboard". I didn't notice that, I thought they were same-level headlines. I stand corrected. And yes, as the logic in this feature seems to be not quite simple, it won't be easy to describe it simply. But I find the drag-from-cursor method quite easy, so I thought it should be mentioned in the guide.

ssahla ( 2014-01-11 12:25:31 +0300 )edit

@ssahla - I agree with you that the differences are miniscule, and therefore easy to interpret as same-level headlines, and yes, if there was an easy way to describe both options ("tap, then tap-drag in any direction", and "slight-press on cursor, then drag sideways"), the Treasure in question would be much more useful if re-written.

Maybe a "re-position cursor in text"-section just above the "Copy and paste" one, same headline-level as "Copy and paste", shortly describing the "tap, then tap-drag in any direction" feature, with the "slight-press on cursor, then drag sideways" as Treasure? :-)

phle ( 2014-01-11 12:51:03 +0300 )edit

This zoom-in to the cursor is a very nice feature and helps editing without arrow keys. It was a bit tricky to learn indeed, but now I get it =)

hana ( 2014-01-18 10:56:20 +0300 )edit

answered 2014-01-16 19:49:19 +0300

foss4ever gravatar image

updated 2014-01-16 19:55:54 +0300

Vocabulary / used terms section missing Even though there was one entry where someone wanted to have a 'cheat sheet' to show all used graphical symbols etc. I think it is even more important to have a vocabulary or index section that defines the key terns used in Jolla UX and SailfishOS.

Focus should be on simple and short definitions of the nain concepts: i.e. UI screens, elenents, behaviours and gestures. Check out this question here: https://together.jolla.com/question/5465/how-to-name-jolla-ui-screens-gestures-and-components/

This question/howto tries to spread the nessage and awareness of naming SailfishOS-related terminology and UX elements:

edit flag offensive delete publish link more

answered 2014-10-13 00:44:40 +0300

axaq gravatar image

Please add a "last changed" or version number to the user guide that we know when somthing has changed. Maybe you could add another page (like http://jolla.com/guide_changes) with a change list or so. Or keep old versions around (like http://jolla.com/guide_version_xyz) that we can make a diff ourself ;-)

edit flag offensive delete publish link more

answered 2014-01-11 20:15:56 +0300

Mohjive gravatar image

In the lock screen section, that the date can be found in the pulley of the lock screen should be made a treasure instead of a simple bullet in a list. It seems that this is an often missed feature.

edit flag offensive delete publish link more


A bit off-topic; Pulley menu shouldn't contain static info - thats why ppl don't find it naturally from there ;P

foss4ever ( 2014-01-16 10:27:51 +0300 )edit

That's another discussion ;) But as long as it's there, it could be mentioned...

Mohjive ( 2014-01-16 11:07:14 +0300 )edit

@Mohjive Hope you noticed the 'off-topic' disclaimer there...Doesn't relate to guide contents, just a comment abt UX being inconsistent here (there are other questions addressing this).

foss4ever ( 2014-01-16 11:17:03 +0300 )edit

answered 2014-01-12 02:40:13 +0300

euj gravatar image


Documentation of the SMS app is simply not there. I'm not sure if the multiple recipients sms behaviour is buggy or not but the multiple recipients thread symbol and concept should be properly explained in the guide.

edit flag offensive delete publish link more

answered 2014-01-16 10:14:08 +0300

AnaT gravatar image

The meaning of "Blinking red" and "solid blue" status LED are missing: https://together.jolla.com/question/15606/what-means-led-blinking-red/#comment-15636

edit flag offensive delete publish link more
Login/Signup to Answer

Question tools



Asked: 2014-01-10 18:41:43 +0300

Seen: 2,355 times

Last updated: Jul 21 '15