Re: [Ubuntu-manual] Fwd: Re: Authors/editors chapter 2
Thanks for your quick feedback Kevin. With regards to 11.10 vs 12.04, we then have an 11.10 reference in the desktop section (that's the only reason I thought of mentioning it in my email after my commit...because I saw it in the manual, but realized I was running 12.04. I'll make sure I find it and "promote" the reference) in my next edits. The explanation of application and menu tags make complete sense. This weekend, I'll align all the tags so they are accurate (in the desktop section anyway). On , Kevin Godby wrote: Hello, Jim. On Wed, May 23, 2012 at 8:13 PM, Jim Connett jimandma...@gmail.com> wrote: > I just finished some sizable edits to the Desktop chapter--starting at The > Dash and going all the way down to just before the Nautilus section. > > I'll do my best to complete the grammatical edits from the Nautilus section > to the end of the chapter by tomorrow evening. Great work – thanks! > One thing that's going to take me a bit of getting used to is knowing when > words get the application tag, or the menu tag, or any other tag. > Specifically, the use of the term "the Dash" and "Launcher"...the tags are > inconsistent right now. I think once I redo the make file, I'll see the > results and probably understand what needs to be done, but any advice, > recommendations, links, etc. for this newbie is of course much appreciated. The application tag is used to denote the name of an application – that is, a program that the user runs. I don't think that term probably applies to the launcher, the dash, and other persistent Unity elements. (I'm open to counter-arguments, though. My opinion isn't particular well-founded here.) The menu tag is used to denote the names of pull-down menus and menu items (eg, File, Edit, View, Print). The other tags typically refer to specific UI elements (buttons, check boxes, etc.). The style guide at http://files.ubuntu-manual.org/style-guide.pdf> has a list of all our LaTeX tags and their uses. If you find anything in there to be unclear or missing, let me know and I'll get it fixed. > I'm also going to need to install 11.10 on a virtual machine before I can > offer screenshots in the Desktop chapter...I'm running 12.04. The current manual is for Ubuntu 12.04. We've already published the 11.10 edition. > Finally, because there were so many changes, I did not "document" them as > well as needed (or probably as expected/required by the group). There were > a couple of points where Hannie had made recommendations to review the > section...or paragraph...or sentence. I reviewed it, fixed it, and deleted > the comment. Other than that, very few comments were inserted as to what > changed. I figure if someone really wants to see the changes, then 'bzr > diff' ! :) You shouldn't have to leave comments behind in the source files. In fact, I generally recommend against littering the source files with comments. Comments may be used as kind of a "note to self" for authors and editors. There's no need to document everything that's been written, edited, etc. – that's what the bzr commit messages are for. > Thank you for this opportunity. Those of you who are edition know it's hard > work...it'll get easier with time, but I'm very thankful to have the > opportunity to contribute back to the community in appreciation for what > I've received over the years of being an Ubuntu enthusiast. We're glad to have your help! Writing and editing a manual is indeed a lot of hard work. And on top of that, we have to learn to use LaTeX, bzr, and other tools – certainly not an easy task! Thanks again for your help and let me know if you encounter and problems or have any questions. —Kevin ___ Mailing list: https://launchpad.net/~ubuntu-manual Post to : ubuntu-manual@lists.launchpad.net Unsubscribe : https://launchpad.net/~ubuntu-manual More help : https://help.launchpad.net/ListHelp
Re: [Ubuntu-manual] Editing Getting Online
Hey, Chris, I agree with you. I started editing this section on June 8th, and before I started, I pulled the latest rev, so I'm sure we're ok. Thanks for the heads-up! Hannie, I hope to finish my editing pass through this section and commit/push tonight. --Jim On , Chris Woollard wrote: It probably alright. I committed my changes last week Chris On Jun 10, 2012 11:42 AM, "Hannie Dumoleyn" lafeber-dumole...@zonnet.nl> wrote: Op 10-06-12 12:05, Chris Woollard schreef: I have edited getting online Chris Hi Chris, Oh dear, Jim has been working on this section too (see email below). Could you guys contact each other about the progress and let me know? I noticed it has not yet been pushed to Launchpad. Regards, Hannie quote from email June 8 to mailing list: Will do...I proof for not only grammar/content, but also for the tex markup as well. I would also like to remind everyone while we are in this crucial phase where a lot of people have their hands in a lot of areas--that we 'commit' as frequently as is reasonable and not sit too long on any changes. This benefits everyone by making everyone's commit process (and conflicts that can and do occur) as painless as possible; it also prevents duplication of author and editor efforts. Thanks. On Fri, Jun 8, 2012 at 8:09 AM, Hannie Dumoleyn lafeber-dumole...@zonnet.nl> wrote: It appeared Carsten had done the conversion for "getting online" (see his mailing to the list), so it is ready for proofreading. Jim, when you have finished proofreading Advanced topics, would you like to do "getting online"? Hannie Op 08-06-12 15:27, Jim Connett schreef: I can take 'getting online' if no one is doing it. ___ Mailing list: https://launchpad.net/~ubuntu-manual Post to : ubuntu-manual@lists.launchpad.net Unsubscribe : https://launchpad.net/~ubuntu-manual More help : https://help.launchpad.net/ListHelp
Re: [Ubuntu-manual] top bar, menu bar, panel or top panel
I believe our path to a resolution lies not in what >we< think is right, or what a majority of a group thinks is right, but what the end user thinks is right. Let me explain. There are several shades of blue (electric blue, navy blue, indigo blue...to name a few). But generally, these variations of blue are accepted as "blue" for (and because of) a variety of reasons. But then we have CYAN. Is it blue? Well, to a generalist, yes. To ME, yes. But to a lithographer, or a printer manufacturer, or a photographer, or a user replacing a printer cartridge, CYAN is a very specific color mix, so to them, and for their purposes, and in their opinion, CYAN is NOT blue. Printer manufacturers have labeled this color as CYAN, all the printer cartridge manufacturers call the color CYAN, therefore, the user searches for a replacement CYAN (not BLUE) printer cartridge. My point. We may say the "top bar" represents one thing while the "menu bar" represents another, and we can debate about the denotation and connotation of the identifiers, but we've not asked the (arguably) more question yet "what is generally accepted?" And by answering that question, we will know what the user will expect, and by knowing what the user expects, we'll all be speaking the same language. While the "Ubuntu Manual Project" is an excellent resource filling a specific niche market, it is not a "definitive guide to using Ubuntu". The UMP is a generalist publication for those wanting to get into Ubuntu but don't want to wade through a 500-page "official manual". We're more of a 150-page "quick start guide". This being the case, we should be in the mindset not to determine and define screen element names, but to support that which has already been defined for us. A discussion amongst ourselves is good, and healthy, but if we determine that a "top bar" is "X" while other manuals, websites, tutorials, etc. identify it as "Y", are we best serving the overall community by presenting these contradictions in print? My recommendation is that we define screen elements the same as the Official Ubuntu Manual defines them...right or wrong. We may even need to coordinate with them...or even contact Canonical directly for input in answering some of these questions. In the interest of serving the user base, it's best that all we are all 100% right or 100% wrong. Anything less adds confusion to the user, and, in the end, detracts from the overall impressiveness of the user supported documentation and--I would argue--the Ubuntu OS in general. --Jim On , Hannie Dumoleyn wrote: With more reactions coming in, I think "menu bar" is the favorite now. The explanation that this bar holds mainly menu's is a valid one. With the term "top bar" one refers to the location of the bar (at the top of the screen), while the term "menu bar" says more about the contents of the bar. @manual team: if we agree on "menu bar", we can start using this term in Quantal. Regards, Hannie Op 11-07-12 04:46, Jeremy Bicha schreef: On 10 July 2012 04:49, Hannie Dumoleyn lafeber-dumole...@zonnet.nl> wrote: As a member of the ubuntu manual team I started a discussion on how we should call this "thing" at the top of our screen. As a translator of the official Ubuntu documentation (yelp) I noticed that the word "panel" had been changed to "menu bar" in the Precise version. I would like to discuss this with people from ubuntu-translators and ubuntu-docs as well. Let me know what you think. The official Ubuntu term is "menu bar". Besides the official Ubuntu documentation, this can be found in multiple places in System Settings such as "Show battery status in the menu bar". The GNOME documentation calls the similar space in GNOME Shell "top bar". Personally, I like the "menu bar" name as the top of the screen includes application menus, application status menus, and system status menus. The only part that isn'ta menu is the window management buttons (close, minimize, maximize) and the app title. Thanks for asking as clear and consistent word choices are important! Jeremy ___ Mailing list: https://launchpad.net/~ubuntu-manual Post to : ubuntu-manual@lists.launchpad.net Unsubscribe : https://launchpad.net/~ubuntu-manual More help : https://help.launchpad.net/ListHelp ___ Mailing list: https://launchpad.net/~ubuntu-manual Post to : ubuntu-manual@lists.launchpad.net Unsubscribe : https://launchpad.net/~ubuntu-manual More help : https://help.launchpad.net/ListHelp
Re: [Ubuntu-manual] 1st pass thru desktop chapter edits on precise e2
After sifting through the Nautilus/Unity malaise Sunday, basically all I was seeing were some menu naming differences (where we were instructing users to click on a specific option in a menu to do a specific action). I now see these were nost likely unrelated to Unity and more related to an update to Nautilus. Thank you for taking the time to install 3D and go through the Nautilus section again. I'm glad to hear the differences between the two are transparent. Someone should confirm the exclusivity of Unity 3D starting in 12.10. If confirmed, current authors/editors can focus on writing/editing in one interface. YEAH! As I've pondered yesterday's changes, I, too, have been questioning whether it's a good thing to mention Unity in the Nautilus section. I'm good with simply making a mention in the Unity section of the "Ubuntu Desktop" chapter that there are two possible interfaces, and while the 'look and feel' may be slightly different between the two, functionality of applications and utilities programs within either interface should not be different. So, tonight (Monday night, PDT), I will move the Unity 2D /3D description up to the Unity subsection, then read through the entire chapter again, making sure I didn't miss anything, and I think I can consider MY edits this chapter DONE. Sound good? On , Hannie Dumoleyn wrote: Hi Jim, Yes, I definitely think we should write about Unity 2D and Unity 3D in our manual. In fact, for the Precise version I did mention this in an email to our mailing list, but there were no reactions whatsoever. On the other hand, if Unity 2D will no longer be supported in 12.10, we should only mention it in the Precise-e2 version. The question is: should it be part of Nautilus File Manager? I don't think so. The standard file manager Nautilus and Unity are two different things. I have currently installed Unity 3D but, so far, in Nautilus I do not see any difference between this environment and my previous one. Could you be a bit more specific in what you see described in the section on Nautilus that is not correct when using Unity 3D? Regards, Hannie btw, I still hs\ave to change menubar inti menu bar, but I will wait until there is more to change in this section. Op 29-07-12 23:42, Jim Connett schreef: Hannie, Thank you for your quick reply, and your support! I regret my statement about removing Nautilus from the manual...it was unfounded and premature...going to "Help | About" showed that Nautilus was still present. Duh...why didn't I think about checking there? I seemed to have been attributing Nautilus' "perceived" differences to what I now understand to be slight influences of Unity 3D and/or Unity 2D on this application's 'look and feel'. I did some research today on the difference between the two shell interfaces. I appear to be running Unity 3D (based on a list of differences between 2D and 3D I was able to find online---if someone has a command-line way to see what interfaces are installed and in use, let me know!) Because there may be differences between what someone may see in 2D vs 3D, I added a 'warning' tag at the beginning of the Nautilus section essentially reminding the reader that the following information (including screenshot) is (now) based on Unity 3D. Maybe this warning should go into the first subsection of this chapter where Unity is first discussed, since Unity influences everything it displays?! I then went through and read each line and tested each command, making changes to menu names and other slight tweaks as needed. Since you are the original author, could you take a few minutes to work through the Nautilus section again to see if it makes sense? Maybe someone else who has 3D can do this as well. I just finished committing and pushing rev 14 to precise-e2 with ALL the changes. Two side-notes: I still could not push to bzr. So, I saved ubuntu-desktop.tex to another folder on my computer, deleted my local precice-e2 folder, pulled the current branch down again, then copied the contents of my ubuntu-desktop.tex to the one just received, committed the file, then pushed, and it worked---I think. Thanks to Carsten for the GUI recommendation...this seems to work a lot better for me as I did the above commit and push without issues from BZR Explorer. I did find in a couple of different resources online stating this is the last LTS where 2D will be supported. With 12.10, 3D is the one-and-only Unity shell, so we need to be watching for these differences in our 12.10 manual. Thanks. On Sun, Jul 29, 2012 at 12:59 AM, Hannie Dumoleyn lafeber-dumole...@zonnet.nl> wrote: Hi Jim, First of all, thank you for what you have done so far in chapter 2. I am responsible for the Nautilus section, so I will answer a few of your questions. Nautilus is still very much present in my Precise (Unity 2D) version. When I open a folder and click in
[Ubuntu-manual] 12.10 Ubuntu Desktop edits done
Just completed, committed and pushed Chapter 2 edits to lp. Edits are all in rev 56. A couple of observations/questions: --screenshots in this chapter still show a username of "Ubuntu". Not sure where we landed on what name was to be used. Not sure if current screenshots are correct in this regard. But I DO know we have a screenshot team. Yeah! :) --Ubuntu 12.10 includes amazon.com search results. Do we want a screenshot showing this? --Can someone please tell me what the little birdy lens is for? Hovering over it gives me no tool-tip. I've googled it trying to find what this does, but I've found nothing, and the search bar in Dash gives me no clues. I assume it's for social networking? Maybe twitter? I've written "social networking" into the manual for now. If someone can let me know the official name, I'll make this edit. -- Hannie, I didn't pay too much attention to the HUD section as there appears to be a comment at the top from you about needing to incorporate updated HUD information from any author who was sending you this information? Are we now good to edit this section? Or shall I wait until this weekend? As a sidenote, I still don't have a good feeling in my tummy with the phraseology we are using to identify the Dash. Sometimes, we are using the article "the" in front of Dash...other times, not. I can argue both sides of this equation and arrive at no conclusion, however, I think we should be consistent...either consistently one way, or consistently the other. So I believe this concludes my assigned edits for this edition. Please let me know if there are any other sections needing another set of eyes. I'll be happy to read through them if requested. --Jim ___ Mailing list: https://launchpad.net/~ubuntu-manual Post to : ubuntu-manual@lists.launchpad.net Unsubscribe : https://launchpad.net/~ubuntu-manual More help : https://help.launchpad.net/ListHelp
Re: [Ubuntu-manual] 12.10 Ubuntu Desktop edits done
Sure... - pg 23: e first icon at the top of the Launcher is the Dash, a major innovation and core element of Unity—we will explore the Dash in a later section of this chapter. pg 25: Dash can help you find the names of files or folders. pg 55: Alternatively, you can click the Ubuntu buon in the top le corner of the screen at the top of the Launcher to bring up Dash and type thunderbird into the search box. pg 66: To start Shotwell, click on Dash near the top-le of the screen, then select the Shotwell icon labeled View Photos. If you do not see Shotwell, simply type Shotwell in the search bar at the top of Dash, and you will see the Shotwell application soon appear. -- It seems that the inconsistencies only appear in the chapter's I've edited--I know...ironic (as fate/luck would have it, these are the only chapters where the Dash is discussed). So, MY preference is to say "the Dash" if everyone is good with that. I'll be happy to make the edits in Chapter 2 and 3 to whatever we agree to. Then...my tummy will feel better. :) --Jim On , Kevin Godby wrote: Hi, Jim. On Mon, Sep 24, 2012 at 4:25 PM, jimandma...@gmail.com> wrote: > As a sidenote, I still don't have a good feeling in my tummy with the > phraseology we are using to identify the Dash. Sometimes, we are using the > article "the" in front of Dash...other times, not. I can argue both sides of > this equation and arrive at no conclusion, however, I think we should be > consistent...either consistently one way, or consistently the other. Can you point me to a couple examples of this? Thanks! --Kevin ___ Mailing list: https://launchpad.net/~ubuntu-manual Post to : ubuntu-manual@lists.launchpad.net Unsubscribe : https://launchpad.net/~ubuntu-manual More help : https://help.launchpad.net/ListHelp
