Bug 119207 - LibreOffice help system does not help for connecting to and using files in a Samba server
Summary: LibreOffice help system does not help for connecting to and using files in a ...
Status: NEW
Alias: None
Product: LibreOffice
Classification: Unclassified
Component: Documentation (show other bugs)
Version:
(earliest affected)
6.0.6.2 release
Hardware: x86-64 (AMD64) Linux (All)
: medium normal
Assignee: Not Assigned
URL:
Whiteboard:
Keywords:
Depends on:
Blocks: Help-Changes-Features
  Show dependency treegraph
 
Reported: 2018-08-10 19:51 UTC by kivi
Modified: 2019-03-31 16:04 UTC (History)
2 users (show)

See Also:
Crash report or crash signature:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description kivi 2018-08-10 19:51:42 UTC
Unfortunately the help of LibreOffice does not help about how to connect from Linux to a Samba server.

Many people are using Samba servers for file shearing between Linux and Windows in the same network. This is because many companies are using together Linux and Windows desktop computers.

But if one such user is trying to connect his Linux based LibreOffice to open/save a file on a Samba share, he/she can not found any useful help. 
Enough clear and practical suggestion how to achieve it is missing in the online or offline help system of LibreOffice.

Please try to open File --> Open... --> Servers...
You can found there around 16 connection options but no any about a Samba share.

If one will try to use the option for Windows Share, the dialog will present him as host the following URL: https://www.googleapis.com/drive/v2 (!?!)
It looks like our regular user willing to connect to his company intranet Samba server, will stop here and could not do noting more.
If he/she clicks the Help button of the form it will be lost as could not found any useful intonation.
This is because for this connection option there are given only 6 rows of information without any example or possible options how to use them.

Also searching the Web does not give exact and practical explanation how one can connect LibreOffice to a Samba server via above Servers... button.

Even it is not clear is it possible at all.
 
My suggestion is to give in the help system more practical explanations with some examples about how to connect.
Such explanations should be written so, to make it easy to connect for any LibreOffice users, not only for the IT hackers.
Comment 1 Olivier Hallot 2018-08-10 21:00:09 UTC
The report actually indicates 3 issues.

1) effectively a the https://www.googleapis.com/drive/v2 is not to be suggested as a Windows share.

--> will open another bug

2)Documentation: The Help page exist actually:

https://help.libreoffice.org/6.0/en-US/text/shared/guide/cmis-remote-files-setup.html

The dialog Help button does not open the right help page, the issue is bug 115254.

3) If the contents of the help page above is not enough for Samba or Windows shares, can you append to this bug the text you would like to see? Thank you.
Comment 2 kivi 2018-08-11 13:30:41 UTC
I've pretty much done writing up to now, and now I have to add a lot more text. Please excuse me for this long additional explanation, but I hope it will help to become clearer what I think about.

My Idea is that help with minimum text about difficult or technical subjects can help to IT people only. But if LibreOffice need to be used by anyone, then such way of explanation does not work.

After supporting many different users of LibreOffice, my personal filling is that many of them can read some help subject and after it could not understood any thing from it, so finally they can not solve their problem.
This is especially where special or technical things are explained expecting users should know the technical things around the aspect and so should understand what to do even from few words.
Unfortunately, especially for not technical people it does not work.

My suggestion is to try to make the explanation text for the very technical or not very clear (straight forward) subjects more explanatory. To try to give info for some possible variants for the needed help solutions. Also if possible to include examples how practically in real life will be done the needed thing. For example instead to read "shared by Windows" it could be written "shared by Windows or Samba"

For example if some non technical user would like to connect to a Samba server he/she may not realize that this will be the same as connecting to Windows share. So I believe some where in the help it need to be mentioned.

Also if in the help suggestion may be given some kind of illustration with correctly adjusted forms to make connection work, then non technical people may help them self copying the given real life example, without to know what means for example "root", "shared resource", "host" etc...

I do not feel my self as a good writer or enough creative person. I believe there are so many creative persons around LibreOffice who can do it much more better than my eventual suggestion text.
Probably I could try to prepare some sample as far I could, but I do not feel my self as a good documentation or text writer.
Comment 3 Xisco Faulí 2019-01-01 19:28:32 UTC
Dear Olivier Hallot,
This bug has been in ASSIGNED status for more than 3 months without any
activity. Resetting it to NEW.
Please assigned it back to yourself if you're still working on this.
Comment 4 kivi 2019-03-31 16:04:38 UTC
Checked it again, this time with LibreOffice 6.2.2.2

Results:
1. Connection to a Samba server still is impossible for regular users
2. The Help system is sitll as useless as in past.
3. No any help word about Linux and Samba server. Just useless mentioning of common words with Windows in mind.
4. The help content is too basic without any example or screenshots to show how to connect.

My feeling is there is zero improvement in the reported problems