Documentation-pages should please be fixed for better experience

[tackin]

e.g. in https://docs.opencloud.eu/docs/dev/server/Services/global/global-envvars/
div class="col docItemCol_MIKF" is set to: max-width: 75% !important;

Why????
I suggest: "max-width: 75% !important" should be deleted entirely to gain the maximum textarea for the table, which are blank otherwise.

It is after all a PITA to have the horizontal scrollbar all the way down at the end of the table. You need to scroll up an down all time to read one single complete row of that table. So please also consider changing the layout for this kind of stuff.

[dragonchaser]

@Svanvith can you please take a look?

[Svanvith]

Thanks for coming up with this.
We'll definitely take a look at it.

As a temporary workaround, you can currently scroll within the table using the arrow keys — hope that helps in the meantime.

[tackin]

I took a look into docusaurus now to learn about how this docu is made.
Usually the *.md-table would somehow reflow the text in columns and make it fit into any frame, but the very long words like "FRONTEND_OCS_PUBLIC_WRITEABLE_SHARE_MUST_HAVE_PASSWORD" in the 3. column are killing that behavior.
The only way I see is to set a new page-style for that pages to use the hole space in the browser-window for the tables.

[tackin]

b.t.w. in docs/blob/main/static/env-vars/global_configvars.md
#Environment variables with global scope available in multiple services
I think should be:
# Environment variables with global scope available in multiple services
(Space missing)

Other files in static should be checked as well for this.

[kulmann]

e.g. in https://docs.opencloud.eu/docs/dev/server/Services/global/global-envvars/ div class="col docItemCol_MIKF" is set to: max-width: 75% !important;

Why???? I suggest: "max-width: 75% !important" should be deleted entirely to gain the maximum textarea for the table, which are blank otherwise.

It is after all a PITA to have the horizontal scrollbar all the way down at the end of the table. You need to scroll up an down all time to read one single complete row of that table. So please also consider changing the layout for this kind of stuff.

Mind to make a pull request if it's such a PITA? 😉 it's an open source project, including the documentation. Happy to have your help.

[tackin]

Mind to make a pull request if it's such a PITA? 😉 it's an open source project, including the documentation. Happy to have your help.

Would be best, indeed but ....
Sorry, that is far beyond my skills. I saw the problem for that page to show up like this, but I did not know anything about the underlying framework and how the page was build. I now found out it's docusaurus but don't have any skills in docusaurus, nor do I have a working local copy of it on my windows PC to play with it and even don't know how to make it work.
I would need to get a local copy of docusaurus running to test my suggestions first, understand the syntax and the tools to manage a layout on certain pages, need to know all about your corporate-layout specifications.
I think it is a PITA to read the table-docu for everybody (programmer and non-programmer) at the moment and just want to point to that problem.
And ... even if I have no glue in GO I still feel free to post any found issue/inconsistency, even if I'm not able to understand the cause nor being able fix it myself. 😉

If I can find a good startingpoint for docusaurus on my windows-PC, I could imagine to pull the docu-repo and start playing with the framework and the repo to perhaps be more of value for the opencloud-project in the future if that helps.

[kulmann]

The repo readme includes instructions how to collaborate on the documentation on your own machine, see https://github.com/opencloud-eu/docs
Would be happy about feedback how this can be improved if it doesn't work for you!

And ... even if I have no glue in GO I still feel free to post any found issue/inconsistency, even if I'm not able to understand the cause nor being able fix it myself. 😉

That's also one of the ideas of open source in general and this project specifically. Very much appreciated, thank you!

[tackin]

My suggestion is in the pull request #361
But these are my very first steps in docusaurus. ... Handle with care! 😉

[tackin]

Next we could think of changing all the static-files with tables like this
my layout-suggestion
to get a smaller text in tables.