Hi Maren, Oh, now I understand much better! But I still have a couple of questions.
I did not want to make this an extra menu item, because that menu item would then lead to a page with only a single link on it. This would not make too much sense, in my opinion.
I don't understand that. Why does it matter if the Keys and Mouse Reference only has 1 link on it?
Why I would not want to put it on the main 'Learn' page is because I consider that page an overview of the sub-sections, which is supposed to help you find the right subsection.
The Learn page happens to be that, an overview with links leading to the sub-pages. But not all of the main menu pages are strictly an overview. For example, the Community page has content of its own, that does not have any sub-pages. And there are sub-pages or sub-menu items which are not previewed on the main Community page.
I do not like the duplication of links too much for maintenance reasons.
I don't understand what you mean about duplication of links.
I guess I would not mind it being on Books and Manuals page, if it was re-named Books, Manuals, Reference, or something that indicates the Keys reference might be there And I see that the command line ref is there too. I didn't realize that was there. It must have been added since the last time I looked at that page.
So if the menu item and page name indicates that references are there, it gives visitors a clue. If I were an Inkscape user who hasn't figured out how to use the Help menu, I probably would not guess that I could find the Keys ref on the Books page.
Books, Manuals and Refs is probably too long for the menu. How about just Manuals and Reference. Because books about Inkscape really are manuals anyway. Or maybe "Manuals, Reference"?
Thanks for discussion :-)
-------------------------------------------------- From: "Maren Hachmann" <maren@...68...> Sent: Saturday, May 23, 2015 1:17 PM To: "Donna Benjamin" <donna@...92...>; "Brynn" <brynn@...78...> Cc: inkscape-docs@lists.sourceforge.net Subject: Re: [Inkscape-docs] more prominent link to the key/mouse ref?
Hi,
okay, so let me explain why I thought it would be good if the link to the keyboard reference lived in 'Books and Manuals'.
To me, a keyboard reference is something that should be part of the manual. It belongs into the 'documentation' section. We do not have a page called 'Documentation', but the thing which is nearest to this is 'Manual'. I would not want to delete it from that page again, because it (for me...) so clearly belongs there.
I did not want to make this an extra menu item, because that menu item would then lead to a page with only a single link on it. This would not make too much sense, in my opinion.
Why I would not want to put it on the main 'Learn' page is because I consider that page an overview of the sub-sections, which is supposed to help you find the right subsection. I do not like the duplication of links too much for maintenance reasons. We will have to exchange the link in several places for the next version and for (up to) 12 languages. That's the kind of work I would like to avoid - the links are version specific, unfortunately.
If we add it in to the section overview page, too, someone needs to want to do all the exchange work. I have done this for one Inkscape version (almost) alone already, and I'd really be happy if it would be limited to the strictly necessary.
If you still want to add it, we can do so, of course - majority vote ;)
Kind regards, Maren
Am 23.05.2015 um 19:21 schrieb Donna Benjamin:
I'd say it makes sense to reference the shortcuts from the learn page.
Via mobile.
On 22 May 2015, at 4:12 am, Brynn <brynn@...78...> wrote:
Hi Maren and all, I think it's neither a book or a manual, so I have some concern about it being on that page. The new FAQ item sounds great though! I guess you must have a reason for not having it on the Learn page? I understand about not being in the menu. I don't agree, but I understand. But to me, Learn page seems more appropriate. Discuss?
Thanks, brynn
From: "Maren Hachmann" <maren@...68...> Sent: Wednesday, May 20, 2015 4:49 PM To: inkscape-docs@lists.sourceforge.net Subject: Re: [Inkscape-docs] more prominent link to the key/mouse ref?
Hi everyone,
I would link them from 'Books and Manuals' and from the FAQ ('Where can I find a list of keyboard commands?' or similar), I wouldn't create an extra menu item for this, and those are the pages where I would look for this kind of info.
I have just added the proposed links to those pages:
https://inkscape.org/en/learn/faq/#Where_to_find_a_list_of_all_keyboard_shor... and https://inkscape.org/en/learn/books/
Any improvement suggestions before I send this out to translators (and translate myself)?
Regards, Maren