Site updates/addressing issues

It is being addressed by the webdesign team. They are aware of what is happening and are working on a solution.

1 Like

@mesiment. We’re already working on a plan to handle redirects in the future. Thanks for your patience as we work to resolve build issues on our website.

1 Like

Tables in documentations are not dispalyed correctly on my iPhone. I’m not sure whether this is due to browser, platform, or screen size.

1 Like

Any documentation? Can you share the URL please?

The screenshot is taken from this https://clearlinux.org/documentation/clear-linux/guides/tooling/mixer

And it also appears here https://clearlinux.org/documentation/clear-linux/reference/bundles#bundles

Thanks. We’ll check.

Another suggestion is about the Clear Linux* Store.

When you click the GET, a floating window pops up tells you how to install it in command line. But a more user-friendly approach is to download the corresponding .flatpakref file like the official flathub, this file can be opened by gnome-software directly.

3 Likes

Do you mind to open an issue in our github?

The hyperlink leads me to the documentation repository, but neither ‘new document’ nor ‘modify document’ sounds appropriate.

So shall I still open an issue on clearlinux-documentation or clearlinux-distribution?

clearlinux-documentation is fine.

Thank you so much.

This happens on Android as well. Has bugged me for some time but keep forgetting to log an issue about it.

I found that this is related to screen size. Changing the line height of the rows in the table would make the text readable.

It needs percentage % instead of pt, at least some inner margin.

1 Like

On the Available Bundles page
https://docs.01.org/clearlinux/latest/reference/bundles/bundles.html

I suggest ANY bundles clearly colour marked red and noted, that have Status Deprecated and Pending-Delete.

Include what the intentions are for replacements, what to with these bundles currently installed etc. Only the Github pages show the status of bundles but no further information is provided as to why pending delete or deprecated and no information is provided as to when or why and what plans are in place to replace them.

This is particular concerning, building a LEMP stack on this OS. My server team is looking for MYSQL server bundle, cannot find it anywhere, he installs database-basic and configures. Today we read that this week the bundle will removed. Now we have very much a concern, when and auto swudp arrives later this week, is it going to delete the database-basic bundle and mess up our production server or will this bundle be automatically replace with something else leaving configuration in place and no disturb the system??

Each bundle on this page should also show version of sources and all included files for convenience reference, because non of this information is even provided on the link github page for the bundle.

1 Like

Further I suggest a tutorial guide for a LEMP Stack not specific to a platform. We use Symfony but writing tutorials for Wordpress is not benefiting a wider audience.

Nginx recommend Mainline, Clear Linux nginx-mainline bundle is close to official build version, minus a few months.

However, bundle nginx (stable) is version 1.14 is actually marked as a Legacy version on Nginx site.

So this it leads us to assume Clear Linux preference is to use nginx-mainline.

In fact Nginx themselves suggest use Mainline over the Stable build even in production.

Database-
Since there’s no bundle for MySQL and database-basics is pending Deletion, the LEMP Stack tutorial should make note of this and explain the recommended replacement is currently MariaDB and to detail the tutorial guide based on bundle installation of the mariadb.

PHP-
Obviously need inclusion thankfully the php-basics bundle status remains at this point Active, so no such stress on this front.

2 Likes

Regarding the requests for highlighting bundles with Deprecated/Pending-Delete status and listing the reasons, I see that this is definitely a gap in our documentation. The workflow we abide by for deprecation/deletion is not very well (if at all) documented.

@biapalmeiro Should this request be routed to the clear-linux-documentation Github repo? The “reasons” may be best tracked alongside the clr-bundles bundle definitions, but I like the idea of the documentation pulling the reasons and clearly highlighting them somewhere in the documentation.

Each bundle on this page should also show version of sources and all included files for convenience reference, because non of this information is even provided on the link github page for the bundle.

Is this a request for the documentation to display the versions of packages for every bundle, and also the files contained in each package?

If so, I’m not sure that this is feasible at the moment. We can certainly generate the metadata in an appropriate format so that the documentation can consume it, but ideally it would need to stay in sync with the Clear Linux OS release cadence, and also provide package version and file listings for the previous N releases as well.

My preference would be to, firstly, improve our tooling to wrap bundle/package/file queries behind a common interface, likely leveraging dnf repoquery to do much of the work.

1 Like

It makes sense to me. @mvincerra thoughts? We would do something similar at https://clearlinux.org/software for consistence.

The gap in the lack of a status could be reflected on this page:
https://docs.01.org/clearlinux/latest/reference/bundles/bundles.html

The above page is automated documentation; it’s simply a script I wrote that captures the current state of https://github.com/clearlinux/clr-bundles/tree/master/bundles

I will discuss possible integration of bundle status with @pmccarty and report back.

2 Likes

From a documentation perspective, I can offer this.

To view packages and their versions, you can use DNF. We added a guide recently to “Query package info from upstream repo” , which you may find useful.

I’ll work on adding a status indicator to the Available Bundles on this page: https://docs.01.org/clearlinux/latest/reference/bundles/bundles.html

1 Like