Bug 160745

Summary: documentation Writer Guide, for example -- list of changes in chapters, also some marks indicating changes
Product: LibreOffice Reporter: peter josvai <jepe>
Component: DocumentationAssignee: Not Assigned <libreoffice-bugs>
Status: RESOLVED INVALID    
Severity: enhancement CC: olivier.hallot
Priority: medium    
Version: 24.8.0.0 alpha0+   
Hardware: All   
OS: All   
Whiteboard:
Crash report or crash signature: Regression By:

Description peter josvai 2024-04-20 12:21:09 UTC
hi, 

it would be great to browse the guide books, say, Writer Guide 24.2, and see the changes in chapters...

For example, looking at the Master Document section in the TOC, 
it would be incredibly great to see if there was anything new compared to the previous version...

The 24.2 version ends at page 379, whereas the 7.6 version ends at 373... 
so, there must be something new!
But wait...
the starting page of the section is also different...
No problem, get the calculator...
383-367 = 16
389-73 = 16...

Oh, so, nothing has changed...
At least it looks so...
But even an additional line could be a whole new functionality...

So, if changes were indicated, notonly browsing the handbook, but also utilizing the functionalities and getting a picture on the current version's state would be way easier...

For a start, a simple asterisk would do... at chapter titles and sub-chapter titles, where changes happened...

For a second run, in subchapters, where changes have happened, a what's new paragraph could be at the beginning, noting if there was any change in the functionalities... or just in the guide's text... or if there was some change in the functionalities, what that was...



- - - thank you for developing Libreoffice.. and Writer - - -
Comment 1 Olivier Hallot 2024-05-13 12:22:05 UTC
Could you please report the issues on Guides in the forum instead? The authors are not reading bugzilla so often.

The forum is a better place to discuss topics on Guides and reach a broader community.

https://community.documentfoundation.org/c/documentation/loguides/14