Need welcome / legal screen

[Kieran Fleming]

On first launch of the application we need to:
Welcome the user
Explain briefly how to use the program
Say that the program is under GPLv3
Say that the program doesn't have a warranty
Say that the maps come from OpenStreetMap

[chris_debian (cjhandrew)]

Could we use the icon as part of the start screen, and make reference to GPLv3 (http://www.gnu.org/copyleft/gpl.html)?

I think GPLv3 covers the warranty bit, but maybe good just to put a one-liner in, stating this. The screen shouldn't be too cluttered, but it would be good to mention (as you stated) OSM, and possible FSF's '4 Freedoms' (http://www.gnu.org/philosophy/free-sw.html)?

Should the screen appear on each boot or just the first time? I would prefer each boot, if we can keep the screen brief and punchy.

[chris_debian (cjhandrew)]

Chris to email OSN-TEAM list after work asking for thoughts on this and also whether someone would like to take ownership, so we can reduce Kieran's workload.

[chris_debian (cjhandrew)]

Email sent to OSN-TEAM list asking for a vlunteer to look into this.

[chris_debian (cjhandrew)]

No response from the list. We may need to slow down a bit whilst we rally more troops.

Maybe I need to publicise OSN. I was going to keep quiet until we were a bit closer to V1.0. I could do it on the Andnav site, but this would totally burn any remaining bridges with Pascal and Nicolas.

Thoughts?

[Guillaume Rosaire (zerog)]

I did some mockup screen yesterday evening and implemented it in Android (even if I'm a beginner, that was rather easy to start with). It's more in the spirit 'Functionnal Code' than 'Pretty Front-end' but that could be a start.

Kieran, did you begin coding something? If not, assign this to me.
What I need now is the text (in english) that I cannot do by myself.

At the moment, it's a simple screen with the OSN icon, the application name, a welcome paragraph, a line on the license with a clickable url to http://www.gnu.org/copyleft/gpl.html, another with a clickable url http://www.gnu.org/philosophy/free-sw.html and an accept/dismiss/continue button.

We should maybe take inspiration on what other free projects state in their welcome screen. Chris, can you help me on this ?

As Kieran said, it should be punchy and not to obtrusive if it's displayed on every start. If we need to have an explanation on how the program works, that should be on another screen, displayed only on first launchs (with a do not show again checkbox, and accessible somewhere in the menu if the user wants to read it once more later).

A clickable link to Opensatnav.org could be added too.

I'm waiting for your welcome/legal text propositions.

[chris_debian (cjhandrew)]

Good work, Guillaume.

Can i suggest that we do not have a continue button. I suspect that if the user selects Accept, then the application will begin. If he/ she Declines, then the application will give a brief message and exit.

At this stage I think the fact that we point to the GPLv3 licence is sufficient. The opensatnav URL could be added, but as we have said, let's not make the screen too cluttered. Any chance you can post/ upload a screenshot?

Thanks,

Chris.

[Guillaume Rosaire (zerog)]

I was not clear enough, I only have one button that I don't know how to label (Accept/Dismiss or Continue).

I'll try to post a screenshot this evening

[chris_debian (cjhandrew)]

Sounds good. I would have thought have an Accept/ Decline option, with the focus (if any) being on the Decline button, so the licence is not Accepted by mistake.

Hope this makes sense.

Well done,

Chris.

[chris_debian (cjhandrew)]

As per original description, we need to:

Welcome the user

### "Welcome to OpenSatNav (icon)"

Explain briefly how to use the program

### Not sure whether this is achievable, here.

Say that the program is under GPLv3

Say that the program doesn't have a warranty

### If I remember, I think this is stated in the GPL, but it may be worth re-iterating.

Say that the maps come from OpenStreetMap

### OSM icon that can be clicked on?

http://www.openstreetmap.org/

Just ideas.......

[chris_debian (cjhandrew)]

Sorry about the paragraph numbering in the last entry, the wiki obviously interprets my three hash signs that way.

[Kieran Fleming (kieran-fleming)]

The GPL is not a EULA, it is a license for distribution. It goes against free software ideals to force the user to agree to anything. My intention was to have something that primarily welcomed users. It is possible to fulfil our legal obligations under the GPL and OpenStreetMap's CC-BY-SA by having an about box, so maybe that's a better idea. I can't think of any help information we need to provide either, as the program is quite easy to use anyway.

[Guillaume Rosaire (zerog)]

Please find attached my first screenshot of the Welcome Screen. I need to fix a few things but that could do it.

You can see behind the welcome message, that the GPS map is loading in the background. Waiting for your thought about that screen.

[chris_debian (cjhandrew)]

Kieran,

I agree with your comments regarding GPL/ EULA.

ZeroG,

That's a very promising Welcome Screen, simple, informative and not cluttered.

Excellent.

[Guillaume Rosaire (zerog)]

* Final text/content must be defined. (I need your help)
* Bug observed with android 1.5 in which no content is displayed at start, just a black window (I already have a workaround) but must be better fixed.
* Must work on each orientation changing which redisplays the welcome screen after it's been dismissed by user.

[Kieran Fleming (kieran-fleming)]

It really needs to be only shown on the first launch. The amount of information we need to show definitely won't work as a splash screen, and it will get annoying to have to dismiss it all the time.

It seems easy to store a setting, see:
http://developer.android.com/guide/topics/data/data-storage.html#pref
I think what would be best is to store an Integer, something like:
welcomeVersionSeen = 1

Then in later versions we can decide to reshow the screen if we have something new to say.
Having the screen only appear on the first launch would also fix the immediate problem of the screen displaying again when the orientation is changed :)

[Guillaume Rosaire (zerog)]

Well I was more thinking that was kind of a welcome splash screen than a panel once only displayed and forgotten.

If it's a welcome screen that will appear just once and never be back, I feel like it's something rather unneeded and I shouldn't have worked on it more than a few minutes (at least I've learned some useful things for my first android dev, not everything is lost)

But this issue shows that we need an about screen, talking about openstanav.org, openstreetmap.org, the licence used, maybe the FSF, and certainly andnav2, in which we could add everything it needs. A new feature to be added ? (That could reuse my code ;-) )

[Kieran Fleming (kieran-fleming)]

Yes, making an about screen seems like the best idea after all this. I apologise for not really knowing what I wanted in the first place. I wasn't sure what kind of attribution was required and I also thought that the app would need some explanation :)

I recommend that we close this and move discussion to http://opensatnav.org/issues/show/42

[chris_debian (cjhandrew)]

Kizza,

Sometimes we have to experience things before we work out where we are going. The fact is we have now arrived at a sensible position with a valid outcome.

I'm going to close this, as you suggested. If anyone wants to, we can always re-open if necessary.

Cheers,

Chris.