[UX] Re-word the 'Congratulations' installation message

[ghost]

Does the

Congratulations, you installed Backdrop CMS!

message you get after installation seem to imply that Backdrop is hard to install and therefore, if you do it successfully, you deserve congratulating...?

Maybe it should be simply:

Welcome to your Backdrop site!

(or something along those lines)

Apparently I'm not the first person to think this. @Bojhan made a similar comment back in 2016: #1908 (comment)

[jenlampton]

I would love to change the welcome message :) What does WordPress say when it's installed?

[domaingood]

I would like to suggest Add Welcome page with some segregation to setup and how to manage help after install.So new user can easily understand where and how to do a simple demonstration with videos document

[ghost]

@domaingood Your suggestions I think are covered by the Dashboard page, which has all those sorts of links and features. But maybe we should link to the Dashboard from the welcome message...?

[klonos]

What does WordPress say when it's installed?

They say "WordPress has been installed. Thank you, and enjoy".

We automatically log the user in, and redirect them to the home page; whereas WP displays a dedicated screen to confirm that everything was installed successfully:

They require an additional step: click on the "Log in" button 👎 ...unless there is a very good reason for doing that, I think we are doing a much better job UX-wise in this step.

How about we say something like this?: "Thank you for installing Backdrop! We've built it with ❤️ for you to enjoy."

But maybe we should link to the Dashboard from the welcome message...?

Yes 👍 ...we could also have a link there to request feedback; something like "Please let us know what we've nailed, and how we could improve further."

[olafgrabienski]

To me, the message "Congratulations, you installed Backdrop CMS!" never implied that Backdrop is hard to install but I see that "Congratulations" may imply it to others.

I'd suggest however to stay with something simple, maybe not "Welcome to your Backdrop site!" (that is already part of the hero) but maybe just "You installed Backdrop CMS!" or "Backdrop has been installed." A short phrase like this would better fit into the flow of the page:

• Welcome hero block
• Message
• Your first post

"Thank you for installing Backdrop! We've built it with ❤️ for you to enjoy."

Sounds a bit wordy to me, and the focus on "us" building Backdrop doesn't go so well with "Your first post", in my opinion.

[stpaultim]

First of all, I don't have a problem with "congratulations." It seems appropriate for me. I think it's appropriate to feel a sense of accomplishment after successfully spinning up a new site, which for beginners is not always as easy as we would like.

Having said that, I'm also good with a thank you message.

"Thank you for installing Backdrop CMS! Please visit your dashboard for tips on getting started." (include link)

[klonos]

Noting that if we are to place a message and link encouraging people to visit the Dashboard, we should first be checking if the module is enabled.

[stpaultim]

Noting that if we are to place a message and link encouraging people to visit the Dashboard, we should first be checking if the module is enabled.

Well, this message only happens at the end of the install process. If the user uses the standard install profile, it will always be enabled. But, if they are using a different install profile, it might not be.

[klonos]

Well, this message only happens at the end of the install process. If the user uses the standard install profile, it will always be enabled. But, if they are using a different install profile, it might not be.

Yes, this message seems to be in https://github.com/backdrop/backdrop/blob/1.x/core/includes/install.core.inc#L1714 which picks the "Backdrop CMS" bit from https://github.com/backdrop/backdrop/blob/1.x/core/includes/install.inc#L211

The distribution name defined in the profile's .info file. Defaults to "Backdrop CMS" if none is explicitly provided by the installation profile.

...so yeah, install_finished() has the possibility to be called by any installation profile - not just the Standard profile. This means that the Dashboard module may not have been enabled, hence why I suggested that we should add the check 😉

[pumpkinsk3]

I am working as a participant of vGHC and working on this issue. I think a short message is always better because in my opinion I lose interest if the message is too long (too many words to read). If this is just an indicator of the success of installation, I think we can use something like "Great, you successfully installed Backdrop CMS!"

[Nimisha94]

Just tested this. This is what it looks like for me. LGTM!

[stpaultim]

This is a pretty simple text change, so I went ahead and marked it RTBC.

[stpaultim]

NOTE: We worked on this issue together as part of vGHC Open Source Day. We decided to break this issue into two parts.

1. A simple text change
2. Create a follow up issue about linking to documentation.

Could someone from OSD, please create a followup issue. In the follow-up issue, link to this issue and describe the part of the task that we did not finish here.

[ghost]

Awesome, I like it! Nice and simple, doesn't imply difficulty, while still indicating installation was a success.

[ghost]

I'm ready to merge this. Someone want to confirm this can go into the next bugfix release by adding the milestone?

[jenlampton]

yes please :)

[ghost]

Thank you @pumpkinsk3 for the PR! Thanks also to @Nimisha94 and @stpaultim for the review. I've merged backdrop/backdrop#3340 into 1.x and 1.17.x.