[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [libreoffice-documentation] Tip Of The Day


HI Heiko, All

Very good idea and start set of tips.

After browsing some on the bottom I think there should be a minimal set
of rules for writing tips. Here are some out of my mind and not exaustive:

* Do not mention releases at all - older or in future (e.g. "5.3
implements table styles in Writer, try them!" or "Version 5.4 introduces
Pivot Charts")

* Prefix or mention module name where it applies (e.g. cells in Calc or
Writer? Styles in Calc or Writer?)

* Consider writing English for ease of translation. Tips must be translated.

* Avoid cryptic jargon, because readers are end users. E.g do not write
thinks like "You can use UNO command XYZ to instantiate your methods for
reflecting objects with XSpreadsheet interface". This sounds idiot to
end users.

Some other questions...
* Is there a max size for the tip in characters?
* Will the tips be segmented per module (should!)
* Localization of images?

Kind regards

Olivier


Em 10/04/2019 12:16, Heiko Tietze escreveu:
> We have the awesome daily tip on Twitter and shouldn't withhold this great resource of knowledge to our actual users. So I implemented a tip-of-the-day dialog that pops up once per day when a module is started. There is no sequence and the "Next tip" button and what comes the other day is random (just to not store the last used id). Advanced users can easily disabled the dialog. It will be in the nightly build tomorrow (or the next days).
>
> For now I used the strings from https://pad.documentfoundation.org/p/marketing. But not all tips are up-to-date and it may need some revisions for proper English. I'd like to ask you to go through the list and change the strings or remove, if needed. Of course, additions are also also welcome. For collaborative work it's shared on https://nextcloud.documentfoundation.org/s/D6zAC5wddW83xWT
>
> Every string may contain of _one_ hyperlink, which is separated from the text (taken from "http" until the end of the line). Single \ need escaping \\.
>
> Last but not least every tip can have a small illustration (max 120px IIRC; larger sizes increase the dialog width). The first tip searches for tipoftheday_0.png, the second for tipoftheday_1.png etc. If not present, the light bulb from our gallery is shown. I believe those images could be a really cool eye catcher and helpful to get the point of the tip. That's a task for our great designers. Just send me the images or store it somewhere.
>
> Thanks a lot in advance,
> Heiko
>
>

--
Olivier Hallot
LibreOffice Documentation Coordinator
Comunidade LibreOffice
Rio de Janeiro - Brasil - Local Time: UTC-03:00
http://tdf.io/joinus

--
To unsubscribe e-mail to: documentation+unsubscribe@global.libreoffice.org
Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette
List archive: https://listarchives.libreoffice.org/global/documentation/
Privacy Policy: https://www.documentfoundation.org/privacy

Follow-Ups:
Re: [libreoffice-documentation] Tip Of The DayHeiko Tietze <tietze.heiko@gmail.com>
References:
[libreoffice-documentation] Tip Of The DayHeiko Tietze <tietze.heiko@gmail.com>
Privacy Policy | Impressum (Legal Info) | Copyright information: Unless otherwise specified, all text and images on this website are licensed under the Creative Commons Attribution-Share Alike 3.0 License. This does not include the source code of LibreOffice, which is licensed under the Mozilla Public License (MPLv2). "LibreOffice" and "The Document Foundation" are registered trademarks of their corresponding registered owners or are in actual use as trademarks in one or more countries. Their respective logos and icons are also subject to international copyright laws. Use thereof is explained in our trademark policy.