Bug 38957 - Univention Apps and first steps
Univention Apps and first steps
Status: CLOSED FIXED
Product: UCS
Classification: Unclassified
Component: App Center
UCS 4.0
Other Linux
: P5 enhancement (vote)
: UCS 4.1-2-errata
Assigned To: Jürn Brodersen
Erik Damrose
:
Depends on: 40528 40626 40923 40930
Blocks: 40006 40827
  Show dependency treegraph
 
Reported: 2015-07-17 22:56 CEST by Stefan Gohmann
Modified: 2016-08-03 15:56 CEST (History)
3 users (show)

See Also:
What kind of report is it?: ---
What type of bug is this?: ---
Who will be affected by this bug?: ---
How will those affected feel about the bug?: ---
User Pain:
Enterprise Customer affected?:
School Customer affected?:
ISV affected?:
Waiting Support:
Flags outvoted (downgraded) after PO Review:
Ticket number:
Bug group (optional):
Max CVSS v3 score:


Attachments
Mockup of the appliance category in UMC overview (620.69 KB, image/png)
2016-01-28 14:08 CET, Alexander Kläser
Details

Note You need to log in before you can comment on or make changes to this bug.
Description Stefan Gohmann univentionstaff 2015-07-17 22:56:25 CEST
It should be possible for an ISV to add first step informations: FIRST_STEPS_{DE,EN}. Maybe we can simply use the existing README_POST_INSTALL files?

Anyway, these informations should be shown during the Univention Apps setup process or at the end of the process or on the welcome screen or at the first UMC login.
Comment 1 Alexander Kläser univentionstaff 2016-01-12 17:31:14 CET
Another piece of text that needs to be clarified on the system activation:

* Instead of "App provider" we should say the name of the provider (e.g., 
  "ownCloud").

* It would be nice to clearly state what kind of license it is that one needs to
  upload. There is a danger that it is confused with an app license, e.g.:

> "A license file has been sent by Univention to xyz@abc.de. This file is needed 
> to activate the system in order to recieve updates for the operating system
> or install other apps.
Comment 2 Alexander Kläser univentionstaff 2016-01-28 14:08:50 CET
Created attachment 7433 [details]
Mockup of the appliance category in UMC overview

Attached the current mockup screenshot of the UMC overview page and the appliance category with the first steps hint. The hint would be only visible for the appliance category.
Comment 3 Alexander Kläser univentionstaff 2016-02-01 13:46:08 CET
(In reply to Alexander Kläser from comment #2)
> Created attachment 7433 [details]
> Mockup of the appliance category in UMC overview
> 
> Attached the current mockup screenshot of the UMC overview page and the
> appliance category with the first steps hint. The hint would be only visible
> for the appliance category.

I set a dependency to Bug 40528 which is needed for this bug.
Comment 4 Johannes Keiser univentionstaff 2016-03-03 13:51:46 CET
On login the first steps will be shown on the appliance category

r 67870
univention-app-appliance-branding (0.2.2-3)
Comment 5 Jürn Brodersen univentionstaff 2016-03-11 11:32:11 CET
The first steps aren't shown immediately after login. If you change the category before they are shown they will be displayed on the category you switched to.
Comment 6 Alexander Kläser univentionstaff 2016-03-15 11:53:21 CET
A link to /ucs-overview is currently missing.
Comment 7 Alexander Kläser univentionstaff 2016-03-18 11:05:21 CET
Translations are currently missing for the appliance category, as well.
Comment 8 Alexander Kläser univentionstaff 2016-03-23 11:27:55 CET
(In reply to Stefan Gohmann from comment #0)
> It should be possible for an ISV to add first step informations:
> FIRST_STEPS_{DE,EN}. Maybe we can simply use the existing
> README_POST_INSTALL files?
> 
> Anyway, these informations should be shown during the Univention Apps setup
> process or at the end of the process or on the welcome screen or at the
> first UMC login.

We (Dirk and me) decided that the most sensible way for information about the first steps would be to use the README file. Any other information which has the character of "further information" (e.g., additional information about licensing, installation of other packages, updates etc.) should be put into the long description in order to allow users to see this information at any time (also prior installing the app). The README file will then be displayed primarily after an installation and should only show information which is of interest in order to put the app into operation (e.g., how to create users, how to access the web interface).
Comment 9 Alexander Kläser univentionstaff 2016-03-24 18:16:21 CET
In the current state, the first steps are working. One last thing to do would be to optimize the speed with which the info box is shown in the UMC overview page. Currently, this may take up to 5sec.

univention-app-appliance-branding (0.2.2-19):
r67819 | Bug #38957: Adjusted styling
r67816 | Bug #38957: Added stylus file and adapted template
r67808 | Bug #38957: Added conffile for modules/appliance.xml
Comment 10 Jürn Brodersen univentionstaff 2016-04-04 12:46:41 CEST
univention-app-appliance-branding (0.2.2-19):
r68339 | Bug #38957: speed up the loading of the first steps
Comment 11 Alexander Kläser univentionstaff 2016-04-06 14:01:12 CEST
Would it possible, to add the following paragraph by default at the beginning of the README file:

"Welcome to Univention Management Console (UMC)! It is the web interface to manage this appliance. UMC is provided by Univention Corporate Server, the platform on which <applianceName> is running on."
Comment 12 Jürn Brodersen univentionstaff 2016-04-07 12:33:17 CEST
univention-app-appliance-branding (0.2.2-23):
r68456 | Added a static header to the first steps; update old symlinks
Comment 13 Alexander Kläser univentionstaff 2016-04-08 11:44:27 CEST
Little suggestion for rewording the German phrase:
"Willkommen auf Univention Management Console (UMC), die Administrationsoberfläche Ihrer Appliance. UMC wird zur Verfügung gestellt von Univention Corporate Server, der Plattform auf der %s läuft."

... maybe accordingly in English:
"Welcome to Univention Management Console (UMC), the administration interface for your appliance. [...]"
Comment 14 Jürn Brodersen univentionstaff 2016-04-08 14:47:50 CEST
univention-app-appliance-branding (0.2.2-25):
r68512 | Bug #38957: changed text in the first steps header
Comment 15 Erik Damrose univentionstaff 2016-06-27 11:57:57 CEST
OK: First steps are displayed via README files
OK: appliance category
OK: translations
OK: YAML

info: source package was renamed to univention-app-appliance
Verified
Comment 16 Janek Walkenhorst univentionstaff 2016-08-03 15:56:27 CEST
<http://errata.software-univention.de/ucs/4.1/229.html>