on xenial help sign in
Amend to promote reporting Unity8 issues in the proper issue tracker (#53)

* Update README.md I notice that many are reporting issues with Unity8 in the wrong issue tracker, namely on the Unity8 installer issue tracker, probably because that's where the installation instructions are found. Moving the installation instructions to this readme (and pointing to this readme in the readme found in the installer repository) may reduce this problem moving forward. * Update README.md I notice that many are reporting issues with Unity8 in the wrong issue tracker, namely on the Unity8 installer issue tracker, probably because that's where the installation instructions are found. Moving the installation instructions to this readme (and pointing the readme found in the installer repository to here) may reduce this problem moving forward.

commitb69d2af5191854e4900d3bf9bc1f0d0973d78779 authorGizmoChicken <9044094+GizmoChicken@users.noreply.github.com> dateSun 22 Jul 2018, 08:45 (8 years ago) parent73bb1aa
1 file changed+37−2
README.md+37−2
README.md+37−2
@@ -2,11 +2,46 @@
22
33A convergent desktop environment.
44
5−Only issues with this (the latest) version of Unity8 should be reported in [the issue tracker](https://github.com/ubports/unity8/issues) on this repository. Issues with the version of Unity8 that's currently running on Ubuntu Touch devices should be reported on [the Ubuntu Touch tracker](https://github.com/ubports/unity8/issues). This will change once Ubuntu Touch moves to the latest version of Unity8.
65
76[![Unity 8](http://ubuntufun.de/wp-content/uploads/2016/05/screenshot20160518_232322980.png)](https://unity8.io)
87
9−See [CODING](CODING) for build instructions. The latest development preview can be [installed on Ubuntu 16.04 and 18.04](https://github.com/ubports/unity8-desktop-install-tools).
8+
9+### How to install
10+
11+The latest development preview of Unity8 for desktop can be installed on Ubuntu 16.04 (xenial) and 18.04 (bionic) as follows:
12+
13+1. Run the install script
14+```
15+bash <(wget -qO- https://raw.githubusercontent.com/ubports/unity8-desktop-install-tools/master/install.sh)
16+```
17+2. Reboot, select "unity8" at the login prompt, and enjoy :)
18+
19+
20+**NOTE:** The above installation instructions currently only work on Ubuntu 16.04 (xenial) and 18.04 (bionic). Please be aware that the script will install the latest *development preview* of Unity8 for desktop. ***Expect bugs!*** Only install this preview if you understand the risks and are willing/able to fix your system if the preview breaks anything. You are advised *not* to install this preview onto a production system.
21+
22+See [CODING](CODING) for build instructions.
23+
24+
25+### Where to report issues
26+
27+Issues related to the version of Unity8 for desktop (the latest development preview) installed using the above instructions should be reported on the [Unity8 issue tracker](https://github.com/ubports/unity8/issues) in *this* repository.
28+
29+Note that issues related to the version of Unity8 that currently runs on Ubuntu Touch devices should *NOT* be reported in this repository, but instead should be reported on the [Ubuntu Touch issue tracker](https://github.com/ubports/ubuntu-touch/issues). This will change once Ubuntu Touch moves to the latest version of Unity8.
30+
31+
32+### What works / what does not work
33+
34+*This list is incomplete, please help improve it*
35+
36+What works:
37+- Most Wayland apps work
38+- Many report being able to login using LightDM, but may require a few attempts
39+
40+Does not work:
41+- Most Xapps don't (yet) work
42+- Proprietary drivers don't (yet) work
43+- Many report being unable to login using GDM
44+
1045
1146### Get involved
1247