Bug 104768 - Poor linking to Macro documentation
Summary: Poor linking to Macro documentation
Status: NEW
Alias: None
Product: LibreOffice
Classification: Unclassified
Component: Documentation (show other bugs)
Version:
(earliest affected)
5.2.3.3 release
Hardware: All All
: medium normal
Assignee: Not Assigned
URL:
Whiteboard:
Keywords:
Depends on:
Blocks: Macro-Documentation
  Show dependency treegraph
 
Reported: 2016-12-19 02:37 UTC by Howard Johnson
Modified: 2024-03-19 20:12 UTC (History)
4 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 Howard Johnson 2016-12-19 02:37:21 UTC
PROPOSED SOLUTION:  I imagine the simplest solution might be to append this link:

   https://wiki.documentfoundation.org/Documentation/Publications 

to this page:

   http://www.libreoffice.org/get-help/documentation/

-------------------------------------------
PROBLEM:  Perhaps a html link was accidentally deleted from LibreOffice.org, but at the moment, an important link to LO documentation is mislocated I think.
 
Let's take the example of drilling down to find the LibreOffice Base Handbook, containing Chapter 9, "Macros".  

The only link I can find to it is from here: 
  
  https://wiki.documentfoundation.org/Documentation/Publications

The trouble is, how does one get from LibreOffice.org, to this page to find it?

If you start at LibreOffice.org and click on Get Help | Documentation, you won't find any reference to this important Base documentation manual covering Macros.


Notes:

  1: I've also looked through the other resources from LibreOffice.org | Get Help | Documentation, leading here:  http://www.libreoffice.org/get-help/documentation/ but the resources there are only introductory, and for recorded macros.

  2: So far, I've found the LibreOffice Base Handbook the very best, most recent, LO resource to explain Macro programming.  If there is something newer, and/or more obvious, I would be interested.

  3: Here's how you can, circuitously, drill down to this documentation from LibreOffice.org:

     * You have to click on "Community" and then select "wiki", which I don't think is a very obvious way to find documentation.  

Here is that procedure in detail:

--------------------------------------------
Starting at:  http://www.libreoffice.org/

	Click "Community" on the menu, then select "Wiki"
		

This takes you to:  https://wiki.documentfoundation.org/Main_Page

	Then go down to "Teams", and "Documentation", and click on: "Guides"


This takes you to:  https://wiki.documentfoundation.org/Documentation/Publications where you can scroll down to find this manual:

	Browse down to: "LibreOffice Base Handbook", 
          then down to "chapter 9 Macros"


-------------------------------------------
Thanks for your work on this!
Comment 1 Olivier Hallot 2017-01-11 22:08:44 UTC
On Version 5.3 a new entry in the Help menu will bring user to this documentation site:

http://documentation.libreoffice.org

which has more books available and download is immediate.
Comment 2 Rafael Lima 2021-03-31 12:31:03 UTC
If you click Help -> User Guides, the following link will open:

https://documentation.libreoffice.org/en/english-documentation/

Maybe we can close this bug report as NOTABUG.
Comment 3 Howard Johnson 2021-03-31 16:32:31 UTC
I'm sorry, but how do you get 


from here:

    LibreOffice.org


to here:

    https://wiki.documentfoundation.org/Documentation/Publications


?


This is an important page to get to!
Comment 4 Rafael Lima 2021-10-07 14:38:11 UTC
Maybe we could add a link in this page:
https://documentation.libreoffice.org/en/english-documentation/

That redirects to the Wiki page:
https://wiki.documentfoundation.org/Documentation/Publications

The link could be called "View All Published Documentation".

@Ilmari what do you think of this idea? How could we go about doing this?
Comment 5 Buovjaga 2021-10-07 14:51:16 UTC
(In reply to Rafael Lima from comment #4)
> Maybe we could add a link in this page:
> https://documentation.libreoffice.org/en/english-documentation/
> 
> That redirects to the Wiki page:
> https://wiki.documentfoundation.org/Documentation/Publications
> 
> The link could be called "View All Published Documentation".
> 
> @Ilmari what do you think of this idea? How could we go about doing this?

I don't know, have to ask Olivier
Comment 6 Olivier Hallot 2021-10-07 15:29:27 UTC
The purpose of 

https://documentation.libreoffice.org/en/english-documentation/

is to offer end-users a quick way (1-click) to get the publication.

Old habits dies hard (ease of use...), community members are used to wiki for storing finished files. Not even Nextcloud is appreciated for the final doc's storage/publication.

I have no preference. I'm all ears.

But there are 2 different demands to be addressed in revamping web pages:
- Quick access for doc consumer (click-and-go), easy navigation.
- Flexible/+complex access for doc creators (upload/download/edit/publish/etc...).
Comment 7 Mike Kaganski 2024-03-19 03:39:08 UTC
IMO:
1. The content on the http://www.libreoffice.org/get-help/documentation/ (which redirects to https://documentation.libreoffice.org/en/english-documentation/ for me) needs a huge cleanup. It should only contain a handful of items; the repeated "Calc Guide" for a dozen of versions is not OK. There should be exactly one entry for Calc guide there, one entry for Writer Guide, etc. - maybe with a selector of version, or only for the latest version...
2. The link to the wiki, that is requested in comment 0, should be there, too - allowing interested users to get into any detail level they wish, as a second step..
Comment 8 Mike Kaganski 2024-03-19 03:40:49 UTC
(In reply to Mike Kaganski from comment #7)
> 2. The link to the wiki, that is requested in comment 0, should be there

And indeed, it is there already, just buried at the very end of that huge list, making very sure that no one sane user would ever reach to that point ;)
Comment 9 fpy 2024-03-19 20:12:17 UTC
(In reply to Mike Kaganski from comment #8)
>  huge list

an idea ...
https://documentation.libreoffice.org/de/documentation/