search

OpenMediaVault-Plugin-Developers / docs

Repo for documents
214 stars 31 forks source link

web version #5

Closed rradar closed 4 years ago

rradar commented 4 years ago

It's 2020 :tada:

ryecoaaron commented 4 years ago

Yep and what browser doesn't render PDFs as web page?

rradar commented 4 years ago

github is rendering the pdf's as images using the latest version of chrome which kills all links in the guide for example. And it's not responsive which makes it hardly usable with mobile devices...

I would even prefer to have that guide somewhere hidden in a forum instead of having it locked up in pdf's on github

ryecoaaron commented 4 years ago

It is "locked up" on github because the filesize is too large to attach to the forum.

rradar commented 4 years ago

image

Over 1.5 million bytes for a file is too large to attach to a forum in 2020? :thinking:

votdev commented 4 years ago

image

Over 1.5 million bytes for a file is too large to attach to a forum in 2020? thinking

It's no problem, but to keep the database small the size is limited. The problem is which size is the right one? A user with a 1.5MiB file says it's too less. So allowing up to 2MiB. The next one says i need 2.1MiB. ...

ryecoaaron commented 4 years ago

That one PDF might be ok but what about the others? OMV is used by more than just Armbian/OMV 5 users.

flmaxey commented 4 years ago

github is rendering the pdf's as images using the latest version of chrome which kills all links in the guide for example. And it's not responsive which makes it hardly usable with mobile devices...

The instructions clearly state: On the forum: To be able to copy and paste commands from these guides, and to use provided links, download the appropriate PDF and view it locally. On GitHub in readme.md: To use the links available in these documents and to enable copy & paste, download the PDF's and view them locally. Please note that I'm not trying to be insensitive as I ask this question; is there some other way I could have made that more clear? Perhaps something on the first page of all doc's?

The forum already has an enormous amount of data stored in it's thousands of threads, with picture and file attachments. It's not the place to store large documents that need regular modification and are downloaded frequently. If for no other reason, the bandwidth requirement would have an unnecessary performance impact.