GNOME Bugzilla – Bug 543883
user docs issues
Last modified: 2011-08-24 13:47:43 UTC
Remaining issues copied from bug 438479 which I just closed. #: evolution.xml:325(para) msgid "Select to use a secure (SSL) connection." msgstr "" #: evolution.xml:326(para) msgid "If your server supports secure connections, you should enable this security option. If you are unsure if your server supports a secure connection, contact your system administrator." msgstr "" TLS is not explained at all. #: evolution.xml:319(para) msgid "If you don't know the Server, contact your administrator." #: evolution.xml:326(para) msgid "If your server supports secure connections, you should enable this security option. If you are unsure if your server supports a secure connection, contact your system administrator." #: evolution.xml:332(para) msgid "If you are unsure what authentication type you need, contact your system administrator." that's so lame. i don't have an administrator here. i always felt fooled when i got that "you're too dumb, ask your non-existing admin" pop-up under windows. please mention the ISP. #: evolution.xml:6461(glossterm) msgid "switcher" ca, c'est merde! how can one translate this? it's never used in the UI. the glossary entry also does not mean anything. bad. #: evolution.xml:451(para) msgid "Select apply filters to new messages in inbox on this server to apply filters." #: evolution.xml:454(para) msgid "Select check new messages for junk contents to filter new mails for spam mails." souldn't that be something like this?: msgid "Select »Apply filters to new messages in INBOX on this server« to apply filters." Comment #54 from Andre Klapper (reporter, points: 28) 2007-05-16 01:48 UTC [reply] #: evolution.xml:515(para) msgid "Select if you want to leave messages on the server." msgstr "Wählen Sie, ob die Nachrichten auf dem Server belassen werden sollen." #: evolution.xml:518(para) msgid "Select if you want to disable support for all POP3 extensions (support for POP3)." isn't this total bullshit buzzword crap, as if the user was too stupid to read, so i just tell him the same thing twice? repeating the exact same wording over and over again this nothing to do with "Help", nothing. instead, explain what it means. what are POP3 extensions at all? the "Include Threads" feature in the advanced search is not listed in the help file ah well... that sentence does not make sense to me: "The compressed columns have Sender Name and Email, Attachment Icon, Date and Subject in the second line" what is in the first line then? aren't we talking about rows instead of columns here? #: evolution.xml:1154(para) msgid "To set your proxy in KDE:" #: evolution.xml:1157(para) msgid "Click the menu icon > System > Configuration > Yast." sounds very Novell-/SuSE-specific and should be change to the default GNOME. #: evolution.xml:1457(para) msgid "The icons in the toolbar are explained in <link linkend=\"tooltip\">tool-tips</link>, which appear when you hold your mouse pointer over the buttons. The buttons fall into five categories:" #: evolution.xml:1459(title) msgid "Headers and Lists:" #: evolution.xml:1460(para) msgid "At the left edge of the toolbar, you can choose Normal for a default text style or Header 1 through Header 6 for varying sizes of header from large (1) to tiny (6). Other styles include preformat, to use the HTML tag for preformatted blocks of text, and three types of bullet points for lists." at the left edge, there is the font size, and not header and lists. this is wrong. you're mixing "tab" and "window" all the time, e.g. with regard to the default tab, it's often called default window. this is confusing. please use tab whenever you talk about a tab. #: evolution.xml:3494(para) msgid "Click Calendars on the Switcher, then click New > Appointment." i don't get that one. don't we talk about the calendar view itself? or the tool bar? tool bar i guess. the right-click option (the 4th one) is also missing here. #: evolution.xml:440(para) msgid "Select if you want to limit the number of Global Address Lists (GAL)." but in the UI, it is: #: ../camel/camel-exchange-provider.c:61 msgid "_Limit number of GAL responses: %s" so is this a limit of the number of emails one gets back from ONE GAL, or is this a limit for the number of GALs themselves? i guess the first one? when you refer to contacts/mail/tasks/memos/calendar, you sometimes talk about components, sometimes about tools, and sometimes about windows. the UI states that these are "windows". please don't confuse the user. #: evolution.xml:889(bridgehead) msgid "Month Pane" #: evolution.xml:890(para) msgid "The month pane is a small view of a calendar month. argh... you called that also "little calendar" and "mini calendar" in the docs. please stick to the same terms. #: evolution.xml:3396(para) msgid "You can also select an arbitrary range of days in the small calendar just above the switcher at the left. To do this, select the days that you want to view in your calendar." clarify this also here: #: evolution.xml:5843(para) msgid "Shows the week numbers next to the respective weeks in the calendar." #: evolution.xml:5911(title) msgid "Creating a Contact" #: evolution.xml:5912(para) msgid "To add a new contact list, either local or remote:" #: evolution.xml:5915(para) msgid "Click Contacts." #: evolution.xml:5918(para) msgid "Click the down-arrow next to New." #: evolution.xml:5921(para) msgid "Select Contact List." #: evolution.xml:5924(para) msgid "Type a name and location for the Address Book." so you talk about contacts, contact lists, and address books in the same paragraph, and i have no clue at all how to translate this properly. messy. #: evolution.xml:6305(glossterm) msgid "automatic indexing" #: evolution.xml:6307(para) msgid "A pre-downloading procedure that allows Novell® Evolution™ to quickly refer to data. It enables faster searches and decreases memory usage for data displays." WTF? this sounds like total marketing buzzword crap. what is a "pre-downloading procedure"? what exactly does "refer" here mean? what are "data displays"? sigh. #: evolution.xml:1804(para) msgid "When you send a message that is encrypted, you must encrypt it using your intended recipient's public key. To receive an encrypted message, you must make sure that the sender has your public key in advance. For signing messages, you encrypt the signature with your private key, so only your public key can unlock it. When you send the message, the recipient gets your public key and unlocks the signature, verifying your identity." no, when i send a signed message the recipient does not automatically get my public key. he has to have it in advance, this is wrong. #: evolution.xml:2115(para) msgid "For POP mail, filters are applied as messages are downloaded. For IMAP mail, filters are applied to new messages when you open the Inbox folder. On Exchange servers, filters are not applied until you select your Inbox folder and click Message > Apply Filters, or press Ctrl+Y. To force your filters to act on all messages in the folder, select the entire folder by pressing Ctrl+A, then apply the filters by pressing Ctrl+Y." this is at the end of the "Importing Multiple Files" section, I have no idea why. probably it's wrong here. right-click vs right click. everywhere :-) double click vs double click. VCF and vCard and VCard are used. #: evolution.xml:3199(para) msgid "Open the list creation dialog box by clicking the New List button." where is that? #: evolution.xml:4128(para) evolution.xml:5041(para) msgid "In the Start Date field, type the date this reminder note should appear in the recipients’ Calendars." memos do not have recipients, this cannot correctly be translated. #: evolution.xml:3617(para) msgid "If you are using a Novell GroupWise or Microsoft Exchange server, other people on the server can check your schedule to see if you are available at any given time. If you have an appointment that is flexible or that you want to designate as Free rather than Busy time, select the Free box in the Show Time As section. Normally, appointments display as Busy." where is that section? isn't that "Options > Show time as busy" in the menu bar? #: evolution.xml:3724(para) msgid "A meeting can have only one organizer, and only the organizer can add participants. You can designate yourself the organizer of the meeting, but if you are not the original organizer, you can create confusion in the scheduling process. If you want to invite additional people to a meeting without changing the organizer, it is best to forward the first organizer's message to the additional participants." what does "designate" here **exactly** mean? please reword. #: evolution.xml:3769(para) msgid "Adjust the meeting time, either by dragging the meeting borders or by using the Autopick buttons to choose a time automatically, then click Save and Close. Attendees on an Exchange server have the appointment updated automatically; others receive e-mail notification of any change in plans." buttons? i can only see one. there are two other buttons, "<<" and ">>", but they are not mentioned at all in the docs, so i won't touch them. ;-) msgid "You can change the default settings of your send items. Click Advanced Send Options to prioritise, classify your send messages. You can also set the date for reply request so that recipient will know the immediacy and can accordingly response to your message . Enable status tracking and set Return Notification for Mail, Calendar and Task." where? where is "Advanced Send Options"? i have no idea what you talk about. #: evolution.xml:5519(para) msgid "Previous versions of Evolution included directory servers, folder settings, and Exchange delegation in the settings tool. Directory servers can now be set up as contacts groups in the Contacts tool, you can change folder settings in the folder right-click menu, and Exchange delegation is available in the Message Menu of the Exchange tool." an exchange "tool" ("window" in the UI?) does not exist anymore. please correct.
I'm confirming this. Andre: if you need the help, and can point me in the direction of the right evolution.xml file, I'll have a go at clearing these up.
I had a huge cleanup today while watching Tour de France and fixed around 200 bugs. This is all that is left. The Evolution user docs have always been in a bad state (with regard to spelling and grammar) since 2.0, for the ones I have listed here I've either been too lazy or didn't get it. I regularly rant on this topic. :-) The code is in svn, see http://svn.gnome.org/viewvc/evolution/trunk/help/C/evolution.xml for a quick look. If you want to check out the code from svn and work on it, see http://live.gnome.org/SubversionFAQ for more information.
Created attachment 114947 [details] [review] Amendments to Evolution help documentation Here's a patch which sorts out some of these issues. I'm not sure whether I've got all of them quite right, and there's more work to do, but it's a start.
Rocks! Thanks, these are sentences that I (being a normal user) understand!
patch committed with one change (mention both free webmail providers and sysadmins): http://svn.gnome.org/viewvc/evolution?view=revision&revision=35815
These are the remaining issues that didn't get patched: #: evolution.xml:325(para) msgid "Select to use a secure (SSL) connection." msgstr "" #: evolution.xml:326(para) msgid "If your server supports secure connections, you should enable this security option. If you are unsure if your server supports a secure connection, contact your system administrator." msgstr "" TLS is not explained at all. #: evolution.xml:6461(glossterm) msgid "switcher" ca, c'est merde! how can one translate this? it's never used in the UI. the glossary entry also does not mean anything. bad. #: evolution.xml:451(para) msgid "Select apply filters to new messages in inbox on this server to apply filters." #: evolution.xml:454(para) msgid "Select check new messages for junk contents to filter new mails for spam mails." souldn't that be something like this?: msgid "Select »Apply filters to new messages in INBOX on this server« to apply filters." Comment #54 from Andre Klapper (reporter, points: 28) 2007-05-16 01:48 UTC [reply] #: evolution.xml:515(para) msgid "Select if you want to leave messages on the server." msgstr "Wählen Sie, ob die Nachrichten auf dem Server belassen werden sollen." #: evolution.xml:518(para) msgid "Select if you want to disable support for all POP3 extensions (support for POP3)." isn't this total bullshit buzzword crap, as if the user was too stupid to read, so i just tell him the same thing twice? repeating the exact same wording over and over again this nothing to do with "Help", nothing. instead, explain what it means. what are POP3 extensions at all? the "Include Threads" feature in the advanced search is not listed in the help file ah well... that sentence does not make sense to me: "The compressed columns have Sender Name and Email, Attachment Icon, Date and Subject in the second line" what is in the first line then? aren't we talking about rows instead of columns here? #: evolution.xml:1154(para) msgid "To set your proxy in KDE:" #: evolution.xml:1157(para) msgid "Click the menu icon > System > Configuration > Yast." sounds very Novell-/SuSE-specific and should be change to the default GNOME. #: evolution.xml:1457(para) msgid "The icons in the toolbar are explained in <link linkend=\"tooltip\">tool-tips</link>, which appear when you hold your mouse pointer over the buttons. The buttons fall into five categories:" #: evolution.xml:1459(title) msgid "Headers and Lists:" #: evolution.xml:1460(para) msgid "At the left edge of the toolbar, you can choose Normal for a default text style or Header 1 through Header 6 for varying sizes of header from large (1) to tiny (6). Other styles include preformat, to use the HTML tag for preformatted blocks of text, and three types of bullet points for lists." at the left edge, there is the font size, and not header and lists. this is wrong. you're mixing "tab" and "window" all the time, e.g. with regard to the default tab, it's often called default window. this is confusing. please use tab whenever you talk about a tab. #: evolution.xml:3494(para) msgid "Click Calendars on the Switcher, then click New > Appointment." i don't get that one. don't we talk about the calendar view itself? or the tool bar? tool bar i guess. the right-click option (the 4th one) is also missing here. #: evolution.xml:440(para) msgid "Select if you want to limit the number of Global Address Lists (GAL)." but in the UI, it is: #: ../camel/camel-exchange-provider.c:61 msgid "_Limit number of GAL responses: %s" so is this a limit of the number of emails one gets back from ONE GAL, or is this a limit for the number of GALs themselves? i guess the first one? when you refer to contacts/mail/tasks/memos/calendar, you sometimes talk about components, sometimes about tools, and sometimes about windows. the UI states that these are "windows". please don't confuse the user. #: evolution.xml:889(bridgehead) msgid "Month Pane" #: evolution.xml:890(para) msgid "The month pane is a small view of a calendar month. argh... you called that also "little calendar" and "mini calendar" in the docs. please stick to the same terms. #: evolution.xml:3396(para) msgid "You can also select an arbitrary range of days in the small calendar just above the switcher at the left. To do this, select the days that you want to view in your calendar." clarify this also here: #: evolution.xml:5843(para) msgid "Shows the week numbers next to the respective weeks in the calendar." #: evolution.xml:5911(title) msgid "Creating a Contact" #: evolution.xml:5912(para) msgid "To add a new contact list, either local or remote:" #: evolution.xml:5915(para) msgid "Click Contacts." #: evolution.xml:5918(para) msgid "Click the down-arrow next to New." #: evolution.xml:5921(para) msgid "Select Contact List." #: evolution.xml:5924(para) msgid "Type a name and location for the Address Book." so you talk about contacts, contact lists, and address books in the same paragraph, and i have no clue at all how to translate this properly. messy. #: evolution.xml:2115(para) msgid "For POP mail, filters are applied as messages are downloaded. For IMAP mail, filters are applied to new messages when you open the Inbox folder. On Exchange servers, filters are not applied until you select your Inbox folder and click Message > Apply Filters, or press Ctrl+Y. To force your filters to act on all messages in the folder, select the entire folder by pressing Ctrl+A, then apply the filters by pressing Ctrl+Y." this is at the end of the "Importing Multiple Files" section, I have no idea why. probably it's wrong here. right-click vs right click. everywhere :-) double click vs double click. VCF and vCard and VCard are used. #: evolution.xml:3199(para) msgid "Open the list creation dialog box by clicking the New List button." where is that? #: evolution.xml:4128(para) evolution.xml:5041(para) msgid "In the Start Date field, type the date this reminder note should appear in the recipients’ Calendars." memos do not have recipients, this cannot correctly be translated. #: evolution.xml:3617(para) msgid "If you are using a Novell GroupWise or Microsoft Exchange server, other people on the server can check your schedule to see if you are available at any given time. If you have an appointment that is flexible or that you want to designate as Free rather than Busy time, select the Free box in the Show Time As section. Normally, appointments display as Busy." where is that section? isn't that "Options > Show time as busy" in the menu bar? #: evolution.xml:3769(para) msgid "Adjust the meeting time, either by dragging the meeting borders or by using the Autopick buttons to choose a time automatically, then click Save and Close. Attendees on an Exchange server have the appointment updated automatically; others receive e-mail notification of any change in plans." buttons? i can only see one. there are two other buttons, "<<" and ">>", but they are not mentioned at all in the docs, so i won't touch them. ;-) msgid "You can change the default settings of your send items. Click Advanced Send Options to prioritise, classify your send messages. You can also set the date for reply request so that recipient will know the immediacy and can accordingly response to your message . Enable status tracking and set Return Notification for Mail, Calendar and Task." where? where is "Advanced Send Options"? i have no idea what you talk about. #: evolution.xml:5519(para) msgid "Previous versions of Evolution included directory servers, folder settings, and Exchange delegation in the settings tool. Directory servers can now be set up as contacts groups in the Contacts tool, you can change folder settings in the folder right-click menu, and Exchange delegation is available in the Message Menu of the Exchange tool." an exchange "tool" ("window" in the UI?) does not exist anymore. please correct.
I am closing this as OBSOLETE we killed the traditional user manual in favor of a topic-based, Mallard formatted one in Evolution version 3.1.5/3.1.90.