Make the first run wizard more helpful

[juliusknorr]

This PR aims to add some more information to the firstrun wizard, to help users getting started.

Todo:

• Make apps management page only show when the user is an admin
• Use branded name from theming
• Add indicator on what page you are

Input from @nextcloud/designers and maybe @jospoortvliet on the content would be nice. I mainly used some content from the website. Maybe you have some ideas for images/illustrations that would fit better.

We could also add some info pages about the groupware/talk features as well as some new features slide for what is added in major releases. Ideas for that are welcome.

cc @karlitschek

Updated content:

First page with values

Details about clients

Information on apps (for admins only)

More information (help, community, enterprise support)

[enoch85]

Woop woop!

[karlitschek]

@schiessle

[karlitschek]

Very nice! We have to make sure that the messaging we send is correct.
'.. on a server, at home, at one of our providers, or in a data center you know' I suggest to extend this to: '.. on a server, in your company, at home, at one of our providers, or in a data center you know'.
On the first page we should list some of our values. So instead of the many links to sync clients, groupware, stay in touch and others (which we could move to a different page if we want, or not) we should list our values:

• Host you data and files where you decide
• 100% Open Source
• Open Standards and Interoperability
• Community focus

@jospoortvliet What do you suggest here? We need a message that works for community and companies.

@juliushaertl I would suggest to kill the 'Show First Run Wizard again' Button in the Settings and add an 'About' menu entry to the Dropdown menu between 'Help' and 'Log out'

[MariusBluem]

Could we make the content (texts, ...) themeable? Especially for enterprise users, sections like „Contributing“ do not make sense and could be replaced by a „Need help? Call IT departement for help“-section or whatever they want :)

[juliusknorr]

On the first page we should list some of our values.

Good idea.

I would suggest to kill the 'Show First Run Wizard again' Button in the Settings and add an 'About' menu entry to the Dropdown menu between 'Help' and 'Log out'

I'm not sure if it should be that prominent, how if we just move it to the help section as kind of a start page for the manuals? But yes, we should remove it from the sync clients page, since that is not really related.

Could we make the content (texts, ...) themeable? Especially for enterprise users, sections like „Contributing“ do not make sense and could be replaced by a „Need help? Call IT departement for help“-section or whatever they want :)

👍 I'll have a look if we could use some existing custom theme mechanism there.

[karlitschek]

@juliushaertl We want/need some kind of About page anyways. We need to explain better what Nextcloud is, whats special about it and communicate our mission. The idea is to use the first run wizard for that. So it would be great if you could add the 'About' menu entry.

[jancborchardt]

I have to say that from a UX perspective this is all a bit TL;DR. :\ It’s 4 pages of really a lot of text which keep me from simply using my Nextcloud. And most of the things which are written in there I actually already know once I made an account. I mean – the 1st page alone has 5 links.

Sorry if this sounds negative. Onto constructive criticism:
We should better do it in a way like iOS apps and Android apps do it: Respect people’s time, have 3 pages max, very simple illustration/graphic and very little text on each page.

[schiessle]

@juliushaertl I really like your idea, also to have more than just one page to navigate through with a next button. I think having some core values on the first page and keeping it really clear makes absolutely sense. I also think it makes sense to have a about button which brings back the dialog. I think that how it works in many other solutions as well.

If this becomes more like a "About" page, which I would support I would also consider mention the license and link directly to the source code somewhere.

[schiessle]

For the core values, I think it would be nice to have one nice term for each, with a emblem and maybe two or three sentence below to describe what it actually means. Something like here https://userdatamanifesto.org

[juliusknorr]

We want/need some kind of About page anyways. We need to explain better what Nextcloud is, whats special about it and communicate our mission. The idea is to use the first run wizard for that. So it would be great if you could add the 'About' menu entry.

Ok, if there will be some more general information that makes sense to me.

I have to say that from a UX perspective this is all a bit TL;DR. :\ It’s 4 pages of really a lot of text which keep me from simply using my Nextcloud. And most of the things which are written in there I actually already know once I made an account. I mean – the 1st page alone has 5 links.

Sure we should keep that at a minimum but at least provide some information about nextcloud and on how you can get started. I'm fine to reduce the amount of pages. Also 👍 for going for a simpler text and just provide links for more information/to the documentation.

For the core values, I think it would be nice to have one nice term for each, with a emblem and maybe two or three sentence below to describe what it actually means.

Do we have them defined somehwere already, so I can have a look to integrate them nicely?

[jancborchardt]

An important thing to actually do here in the first run screen is to directly get a new person to put in their name, email address (if not there yet), and avatar. We should have these fields directly there so they don’t have to go to the Personal settings.

[juliusknorr]

An important thing to actually do here in the first run screen is to directly get a new person to put in their name, email address (if not there yet), and avatar. We should have these fields directly there so they don’t have to go to the Personal settings.

Yes, that sounds like a good idea if we just show it if there is no data already set from an external user backend like LDAP.

[juliusknorr]

I've updated the screenshots in the first post with the latest state. I've added the values to the first page, with a link to the Nextcloud homepage, maybe @jospoortvliet can tell me if there is a subpage that is better suitable to explain the values a bit more?

Also as @jancborchardt proposed, i tried to reduce the content a bit. Maybe we can also get rid of the apps page, but I like to show off what Nextcloud apps can offer as additional functionality.

@jancborchardt Regarding adding an input for display name/email/avatar, we probably need to adjust some more stuff, since those require reentering the users password at the moment, so I will probably have a look at that in a separate PR.

Please have a look if there is anything missing or can be removed from your POV. @nextcloud/designers @karlitschek @jospoortvliet

[karlitschek]

really nice 👍

[jancborchardt]

Slide 1: 100% Open Source & community-focused can be combined. Making it a nice simple 3-column layout.

Slide 2: The headings and buttons should be center-aligned, looks much better balanced for a centered modal lile this.

Slide 3: No blue background around the image please, as it makes it way too small. First text block can be shortened to: "Find more than 100 apps in the Nextcloud app store to customize your cloud:"

Slide 4: Let's maybe make this a 3-column layout with simple icon-heading-shorttext? Colums would be "More info", " Get involved" and "Enterprise support".

Also, we should really have that ask for real name, email and avatar, if applicable.

[juliusknorr]

Thanks for the comments @jancborchardt I adjusted the PR accordingly. I will look into the displayname setup in a separate PR, so we can get this in for now.

Ready for review @nextcloud/designers

[MariusBluem]

Typo: randsomeware -> ransomware

[MorrisJobke]

👍 Maybe make the a in a safe home for your data uppercase to match with the casing on screen 2 and 3

[juliusknorr]

Fixed the typo and the lowercase letter in "a safe home for your data" as well.

[rullzer]

Awesome stuff!

Lets get this in and do more improvements later.