[libreoffice-design] Re: Minutes of the Design Hangout: 2014-12-10

Jan Holesovsky-4 wrote
> * Updating Help (Cor)
>  
>     + checking the paths for menu, contextmenu and toolbar mentions that
>       are changed (Cor)
>     + has a wikipage with the changes (Jay)
>         + would be good to send the link to the document team (Kendy)
> AI          + send a mail to [hidden email] with
>               the wiki page (Jay)

String changes to the UI are being captured to this Wiki
https://wiki.documentfoundation.org/Documentation/RecentStringChanges


>         + the help is compiled (Steve)
>             + checking this could be in the Moztrap too? (Steve)
>         + Olivier has a meta-bug for help (Jay)
>     + focusing on 4.5 now, more changes there than
>     + https://bugs.freedesktop.org/show_bug.cgi?id=86209#c6
>       "Have you thought in updating the help files to reflect the
>       changes?"
>         + unfortunately the menu is tight to how the menus are organized
> (Stuart)
>             + sequence & layout
>  
>     + unfortunately help is hard to edit (Kendy)
>         + have a plan, but no time to implement, volunteers appreciated
> (Kendy)
>             + need (trivial) searching implemented in JavaScript
>         + php help - http://php.net/manual/en/ (Jay)
>           downloadable version - http://php.net/download-docs.php
>             + unfortunately no search :-( (Kendy)
>         + ms office online help (Jay)
>          
> https://support.office.com/en-in/article/Switch-transpose-columns-and-rows-ed1215f5-59af-47e6-953b-0b513b094dc2
>   

Further to comments at the hangout, beyond just changes to strings and
labels, the structure of many of the compiled Help articles follow the
*sequence* UI elements appear in menus and dialogs. 

As can be seen by reviewing the cgit repo for LibreOffice  Help --
http://cgit.freedesktop.org/libreoffice/help/log/  there are documentation 
actions that have to also be performed in the Help (as well as passed out
for l10n/i18n translation). 

While it can seem a nuisance, every change to the UI  probably requires a
review of the corresponding compiled Help articles--the UX suffers
otherwise--and we've not been keeping that side of the UX up. 

The UI changes should occur, but as changes are being made in rapid
succession, the documentation team needs to be supported. Or better, either
propose the changes, or go ahead and make the commit to the Help at the same
time.

Stuart



--
View this message in context: 
http://nabble.documentfoundation.org/Minutes-of-the-Design-Hangout-2014-12-10-tp4132227p4132279.html
Sent from the Design mailing list archive at Nabble.com.

-- 
To unsubscribe e-mail to: design+unsubscribe@global.libreoffice.org
Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.libreoffice.org/global/design/
All messages sent to this list will be publicly archived and cannot be deleted