Security & Setup Warnings - Documentation

[spaceman_sproggit]

I’ve just installed a copy of 29.0.5 on to a Raspberry Pi 4B/8Gb for home use. Running the db out of a QNAP NAS with MariaDB and all the basics seem to be working fine.

However… I do have 3 outstanding “Security & Setup” warnings. These are:-

1. “One or more mimetype migrations are available…”
2. “The database is used for transactional file locking…”
3. “The PHP Module “imagick” in this instance has no SVG support…”

I’ve hit weird issues with the 1st and 3rd of these items, above. For the first, I am able to successfully invoke the relevant occ script and the on-screen output all looks to be perfectly OK with no issues reported… but when I come back to the Admin Overview panel this warning does not disappear, so it looks like the script might not be working. I am not clear how I might be able to debug this…

Also, with regards to the 3rd item, I understand what Scalable Vector Graphics are… but when I click the provided link offered through “For more details see the documentation…”, the only reference on the page that opens is a single statement in a block which reads,

"For preview generation (optional:
PHP module imagick
avconv or ffmpeg
OpenOffice or LibreOffice

I’ve checked my rPi package manager and I can see that package “php-imagick-3.7.0-5+0” has been installed, but I can also see that the rPi repo does not list any SVG version of imagick.

The problem is that the so-called “documentation” linked from the “Security & setupwarnings” don’t really give me any clues as to how important this might be, or how I might be able to test to determine whether this is something I need to consider addressing… or, perhaps most seriously of all, how I might be able to find the relevant library if it isn’t offered in the rPi repos.

So just a couple of general items of feedback in the hope that the Devs or documentation teams might make an intervention…

1. If you’re going to link to a documentation page from a “warning” message, then the linked documentation page really needs to discuss the warning in a good level of detail. If it doesn’t what’s the point?
2. One of the things that would be really helpful with the “Security & setup warnings” would be a bit more context around the significance of individual messages.

When I started to address these, I had at least one displayed in red font; now I have one in a gold/brown font and two in black text, so I guess this might be intended to be “red”, “amber” and “ordinary” warnings? But it isn’t clear.

And there’s no point in linking to documentation if the destination doesn’t describe the warning in useful detail.

Hopefully these aren’t major issues… but then NC has been around for a while now… so maybe these gaps have been missed or are being ignored?

[wwe]

I’m not really sure what is the goal of your post… documentation can never be perfect and fit different level user experience and expectations. I feel the docs related to setup_warning are “good enough”. Nextcloud supports huge number of platforms and installation methods so it is impossible to provide a docs which perfectly fit each system.

At the moment the is a bug related to the point 1: Mimetype Warning after upgrading to 28.0.9 or 29.0.5. Second on is more than clear and have been often discussed here - use search! the 3rd one is little more complex but here again many different supported platforms make it hard to create good docs…

The project is open source and everybody is welcome to help. If you feel current docs are not good - you are welcome to provide better variant.