GNOME Bugzilla – Bug 559723
"Start Here" note refers to "GNOME Panel", which is inappropriate for Windows, Mac, gnome-shell, and Unity
Last modified: 2016-09-18 12:48:21 UTC
Documentation Section: "Start Here" note You can create new notes to hold your ideas by selecting the "Create New Note" item from the Tomboy Notes menu in your GNOME Panel. Correct version: You can create new notes to hold your ideas by selecting the "Create New Note" item from the Tomboy Notes menu in your Taskbar. Other information:
Haha, nice catch.
*** Bug 568616 has been marked as a duplicate of this bug. ***
This is also a problem for gnome-shell and unity. Let's cover all of these cases in one bug if possible (and make sure that if unity support requires distro patches, it's clear how the patch should be done).
https://bugs.launchpad.net/ubuntu/+source/tomboy/+bug/683575
Oh, right, sucks on Mac too. Updating summary.
The Mallard docs also have to be updated accordingly.
How would this be managed? By some #if defs and compile time switches, or by carefully phrasing the note in a platform-agnostic way? Examples: You can create new notes to hold your ideas by selecting the "Create New Note" item from the Tomboy Notes menu. You can create new notes to hold your ideas by selecting the "Create New Note" item from the Tomboy Notes icon. You can create new notes to hold your ideas by selecting the "Create New Note" item from the Tomboy Notes in your panel/tray.
@Roth: I was under the impression that the Mallard docs already addressed this. @Robert: Good question. For what *we* ship, it could be done as compile-time switches, or by calling a new method on each NativeApplication implementation. For things like Unity, though, that would not be covered. Not sure what the best approach is.
So what's the next step on this?
I can't speak to Windows, but on Mac and Linux, I'd would change the text to: "You can create new notes to hold your ideas by selecting the "Create New Note" item from the Tomboy Notes menu." (Deleting ...in your GNOME Panel".) Similar to how we write GNOME documentation, the goal is to keep it as simple as concise as can be, and I think this works. In Linux, you can create a new note from the Tomboy icon on the panel and in Mac you can from the Tomboy icon in the dock. If Windows is similar (can you do it from the notification tray?) I'd go with the text above.
Created attachment 227103 [details] [review] Removes GNOME Panel from the string
Review of attachment 227103 [details] [review]: Looks fine.
Review of attachment 227103 [details] [review]: Committed with adfcbf4875b36eacf959c3930313a4236986cb0a, reformatting commit message to fit the recommended format. Thanks Jared and Robert.