Re: Commentary on the new API documentation
Hi, please bring up these questions on https://discourse.gnome.org/ . In addition, feel free to file dedicated documentation bug reports for the GTK folks at https://gitlab.gnome.org/GNOME/gtk/-/issues/ Thanks a lot! andre On Wed, 2021-08-11 at 13:06 -0400, Michael Welsh Duggan wrote: > I've encountered a couple of problems with the new API documentation as > presented on the web as opposed to the old documentation. For > reference, I will use https://docs.gtk.org/glib/index.html as an > example. > > The biggest problem relates to constructors. For example, under the > Structs tab I can find String. Clicking on String, I see what a String > is and how to use one. But there is no documentation on that page to > *create* one. Those are found in the Functions tab and are lacking the > g_ prefix. But that information should really be in the page that > describes String. As it exists, this is a major discoverability > problem. > > Second, why are the g_ prefixes removed from the Functions tab? This > just makes things generally inconsistent. > > Is there a reason that documentation that references to other functions > (such as the reference to g_string_printf in the documentation for > g_string_append_printf) are not hyperlinks? This would be a lot more > useful in this new structure where each function is on a separate page. > > As a sub-comment, I think that the Structs tab should probably be > renamed to "Objects", as that is how they are represented in the > documentation. > -- Andre Klapper | ak...@gmx.net https://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Style Guide location?
https://gitlab.gnome.org/GNOME/gnome-devel-docs/-/tree/master/style-guide implies that there is a more recent version of the style guide than the "old-style-guide", however I can only find the old style guide online at https://developer.gnome.org/gdp-style-guide/ Where is a more recent style guide hosted? Nowhere? :-/ Thanks, andre -- Andre Klapper | ak...@gmx.net https://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: Google Summer of Docs proposal 2021
Hi, thanks for the quick reply. Comments inline. On Mon, 2021-03-15 at 09:35 -0700, Sriram Ramkrishna wrote: > On Mon, Mar 15, 2021 at 9:08 AM Andre Klapper wrote: > > On Mon, 2021-03-15 at 08:11 -0700, Sriram Ramkrishna wrote: > > > I'm working on a GSoD for this year and I've outlined the proposal. > > I > > > just wanted to give you all a heads up. I'm mostly focusing on our > > wiki > > > and looking to remove everything updated, and update the ones that > > are > > > still valid. But we will also use that experience to build a better > > > onboarding experience by building a more supportable project > > > documentation setup that can be managed for the future. > > > > > > If you have any thoughts, questions, or comments that would be > > > appreciated. Here is the current proposal. > > > > > > https://etherpad.gnome.org/p/gsod-2021-proposal > > > > I'm trying to understand the scope and complexity of this. > > > > About how many pages are there to audit? > > > > > I don't know off hand. The first phase is to audit it to find the scope > and then flag things for removal or flag for update. Does this imply that both applicants and mentors do not know if the proposal is about spending time reviewing a hundred pages or if the proposal is about spending a bit more time reviewing a million pages? > > > For the "work with community members", have those community members > > committed to allocating sufficient resources? > > > > > I haven't secured any resources. In that particular case, when I say > work with community members, I mean - asking the owner of that project > - "is this information current or can I delete it" So the commitment is > to answer questions about the utility of the content. Primarily I see > my role here to make the introductions on how to talk to - eg I am the > guide/map for stuff in the wiki. Assuming it takes a while to identify the "owner of that project" related to each page, and then finding ways to contact them (e.g. email addresses), and assuming that 80% will not reply (that's more or less my impression from trying to contact maintainers about their projects' tickets left in Bugzilla a few months ago), how does this influence the success criteria for this project and the motivation of the applicant? > > > > > If it's about "building a better onboarding experience", is there an > > analysis available what's bad about the current onboarding experience > > with specific regard to the wiki? > > > > > Only the one analysis I did about two years ago when I went through > them. > There was enough wrong information that onboarding would have been > confusing. I am not sure if I still have the etherpad where I had my > notes there - but it was at our last combined hackfest with the docs > team, engagement team and gtk team. That analysis/audit was only about > 2 levels deep though. Ah, great. Could you provide a link please? > Part of what I want to do is also start focusing on keeping metrics - > so a better onboarding experience also means measuring things better > within the project. > > > > > If it's about "building a more supportable project documentation > > setup", is there an analysis about the current pain points and how > > this > > plays along in combination with documentation in other places such > > as > > help.gnome.org, GitLab wiki pages, or GitLab README.md files? > > > > > I'm not aware of any analysis - the idea of this project is to do > exactly that. The idea is we build a proposal and that proposal has > to include the current pain points (otherwise how does it become > better?) and then we need to convince ourselves that this is a good > solution going forward. > > I think the current wiki setup has not been particularly good if not > altogether ignored. Part of that problem is our own set of process, > but the bulk of our information is moving into gitlab and maybe > gitlab is the right answer, but it needs to be investigated. I don't > think this is an easy project to do - especially when it comes down > to consensus. That's why the project is focused on a proposal as the > end result - not to implement but at least debate. Could you elaborate on "the current wiki setup has not been particularly good"? Is this about taxonomy of content (subpage structure etc), consistency of content (e.g. shared templates for app page layout), or is this about some technical aspects? Thanks, andre -- Andre Klapper | ak...@gmx.net https://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: Google Summer of Docs proposal 2021
Hi, On Mon, 2021-03-15 at 08:11 -0700, Sriram Ramkrishna wrote: > I'm working on a GSoD for this year and I've outlined the proposal. I > just wanted to give you all a heads up. I'm mostly focusing on our wiki > and looking to remove everything updated, and update the ones that are > still valid. But we will also use that experience to build a better > onboarding experience by building a more supportable project > documentation setup that can be managed for the future. > > If you have any thoughts, questions, or comments that would be > appreciated. Here is the current proposal. > > https://etherpad.gnome.org/p/gsod-2021-proposal I'm trying to understand the scope and complexity of this. About how many pages are there to audit? Does "remove" mean deleting pages (and making URLs become 404s if you don't manually [[REDIRECT]]), or 'only' removing content from pages? For the "work with community members", have those community members committed to allocating sufficient resources? "looking at alternative documentation technologies" means potentially replacing the MoinMoin installation by moving stuff to Gitlab (or so)? If it's about "building a better onboarding experience", is there an analysis available what's bad about the current onboarding experience with specific regard to the wiki? If it's about "building a more supportable project documentation setup", is there an analysis about the current pain points and how this plays along in combination with documentation in other places such as help.gnome.org, GitLab wiki pages, or GitLab README.md files? Cheers, andre -- Andre Klapper | ak...@gmx.net https://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Branch off gnome-3-38 in gnome-user-docs?
Can we please branch off gnome-3-38 in gnome-user-docs? We'd need to make a lot of changes for version 40. See https://gitlab.gnome.org/GNOME/gnome-user-docs/-/issues/102 Thanks, andre -- Andre Klapper | ak...@gmx.net https://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: Is docs-feedback@ still on?
Heja, On Tue, 2020-12-15 at 09:36 +, David King wrote: > On 2020-11-30 21:22, Andre Klapper via docs-feedback wrote: > > Test; as I have not seen any feedback for a long time to this > > address. > > I do not know why there has not been any feedback posted to the list > for some time (is it moderated?), Uh, good point... No idea who's listed as list moderators, so I dully emailed before asking sysadmins. > but Shaun and I chatted about this in a prior docs standup, and > wondered if using Gitlab issue templates for reporting problems > might work instead of a mailing list? https://docs.gitlab.com/ee/user/project/description_templates.html (Note that we run CE instead of EE, though usually docs are the same.) In my understanding, setting a default issue template is not possible in our installation (see https://gitlab.gnome.org/GNOME/gnome-desktop/-/issues/182#note_972139 ) so basically nobody will ever manually click that template dropdown thing anyway (I've never done that myself). > The process looks relatively straightforward, but would probably have > to be against a single component, maybe gnome-user-docs, or possibly > a new product solely for general documentation feedback, to have a > single link that can be injected, instead of the docs-feedback list. Sounds a bit similar like the "Get rid of a security mailing list and make people file tickets" past discussion in Release Team. Though in this case... could the project/label parameter in the GitLab URL be adjusted by taking the project name segment in the page URL? Cheers, andre -- Andre Klapper | ak...@gmx.net https://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: Let's start talking
On Fri, 2020-05-15 at 22:11 -0700, Sriram Ramkrishna wrote: > I'm also interested in having the docs team be a partner in the > scalable onboarding process that I'm working on. We can even talk > about that some. > > Here is the initiative - > https://gitlab.gnome.org/Teams/Engagement/initiatives/scalable-onboarding > > It kind of works into some other incubation projects I am working on > in regards to metrics. I would love to work with all of you on how to > implement onboarding so that we can help grow the team and make > documentation that has a lot of people working on it. I'd say that's covered on https://wiki.gnome.org/DocumentationProject which I just cleaned up a bit.[1] It is still a confusing duplication and mess between the content and scope of the pages "Contributing", "Planning", and "Tasks" though, if anyone also has some time. What else is wanted / needed apart from that? I usually understand specific and actionable topics better than high-level dreamy stuff. Cheers, andre [1] (Deleted outdated Roadmap page; removed duplicated Guides on frontpage; clearly state to use Contact info instead of contacting individuals; replace ancient links to Bugzilla queries with Gitlab queries; remove "Bugzilla watching" and link to Gitlab notifications instead; link to reporting guidelines on "Reporting Bugs" page; etc) -- Andre Klapper | ak...@gmx.net https://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: including system icons in help docs
On Mon, 2020-05-18 at 12:13 +1000, Michael Gratton wrote: > > I think it's worth looking into more, but I don't see myself having > > time to look into it myself any time soon. > > Fair enough, I'm in the same boat tbh. Thanks for the reply! Anyone feel free to file a ticket in GNOME Gitlab, because otherwise this mailing list conversation will be forgotten at some point. Thanks, andre -- Andre Klapper | ak...@gmx.net https://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
[FYI] "ApplicationHelp" on GNOME wiki pretty much up-to-date
Hi everyone, as a side effect of updating some docs in random apps over the last weeks, I also checked the state of docs for most apps and updated https://wiki.gnome.org/DocumentationProject/Tasks/ApplicationHelp Hence that page should be mostly up-to-date by now. If you're bored and looking for some docs project, feel free to check that page for ideas. Cheers, andre -- Andre Klapper | ak...@gmx.net https://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: How to take screenshots without getting shadow etc.
On Sun, 2020-01-26 at 04:56 +0100, scootergrisen via gnome-doc-list wrote: > The screenshot tool i tried does not seem to be able to take > screenshot of window without shadow even when i try to turn it off. Feel free to file a bug report if an option does not work as expected: https://wiki.gnome.org/Community/GettingInTouch/BugReportingGuidelines Cheers, andre -- Andre Klapper | ak...@gmx.net https://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: Revisiting the utility of branch notifications
On Thu, 2019-03-14 at 16:55 -0400, Shaun McCance wrote: > My question is, are these notifications still useful? Given how small the Docs team is: No, I do not and cannot care much about branches. I work on docs when I have time and if something is wrong it needs to be fixed, no matter which period we're in in the schedule. (I do check via "git branch -a" or the web interface if something has branched though if I feel that I should check first.) andre -- Andre Klapper | ak...@gmx.net https://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: UI/String freeze break request for gnome-boxes
On Fri, 2019-03-15 at 11:35 -0500, mcatanz...@gnome.org wrote: > On Fri, Mar 15, 2019 at 9:53 AM, Alexandre Franke wrote: > > Thanks for the details you provided, they were helpful in making > > the decision. > > Yeah, this seems sufficiently-exceptional to justify the proposed > changes. r-t approval one of two. r-t approval 2 of 2. andre -- Andre Klapper | ak...@gmx.net https://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: [evolution-data-server] UI/string freeze break approval request
On Fri, 2019-03-01 at 07:14 -0600, mcatanz...@gnome.org wrote: > 1 / 2 release team 2/2 r-t approval andre -- Andre Klapper | ak...@gmx.net https://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: String/UI Freeze Break (#2) - totem
On Tue, 2019-02-26 at 15:58 +, Emmanuele Bassi via release-team wrote: > On Tue, 26 Feb 2019 at 15:32, Bastien Nocera > wrote: > > On Mon, 2019-02-25 at 13:52 +0100, Piotr Drąg wrote: > > > pon., 25 lut 2019 o 13:44 Bastien Nocera > > > napisał(a): > > > > Hey, > > > > > > > > This removes some UI which isn't connected to anything anymore. > > > > There > > > > aren't any screenshots in the user documentation, and the removed > > > > paragraph would automatically be dropped from user docs > > > > translations: > > > > https://gitlab.gnome.org/GNOME/totem/merge_requests/79 > > > > > > > > > > It doesn’t break the string freeze, but thanks a lot for the > > > notification! > > > > Could the release team weigh in with some feedback, please? > > Looks very low impact, so +1 from me (r-t). r-t 2/2 - yes please. andre -- Andre Klapper | ak...@gmx.net https://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: Consistent terminology: "Title bar" vs "Header bar"
On Mon, 2019-01-21 at 20:56 +0100, Petr Kovar wrote: > Might be easiest to just follow the HIG? > > https://developer.gnome.org/hig/stable/header-bars.html.en Thanks. Added to https://wiki.gnome.org/DocumentationProject/Guide/LanguageStyle andre -- Andre Klapper | ak...@gmx.net https://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: Consistent terminology: "Title bar" vs "Header bar"
On Sun, 2019-01-20 at 21:43 +0100, Andre Klapper wrote: > Both terms seem to be used across user documentation. ...which also brings me to the obvious follow-up question how to name the very first button which shows the application icon and clicking it reveals the menu that was previously available in the gnome-shell top bar. Some standard phrase to use (and document on the wiki), basically. andre -- Andre Klapper | ak...@gmx.net https://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Consistent terminology: "Title bar" vs "Header bar"
Both terms seem to be used across user documentation. Which one is preferred? $:acko\> pwd /home/acko/gnome-upstream/GNOME $:acko\> grep --include="*.docbook" --include="*.page" -r "itle bar" . | wc -l 25 $:acko\> grep --include="*.docbook" --include="*.page" -r "eader bar" . | wc -l 89 As "application menus" are deprecated in 3.32, I'd love to document on https://wiki.gnome.org/DocumentationProject/Guide/LanguageStyle andre -- Andre Klapper | ak...@gmx.net https://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
library-web not showing any content for some tarballs
Does anyone know who could investigate https://gitlab.gnome.org/Infrastructure/library-web/issues/12 ? https://gitlab.gnome.org/GNOME/gtkmm/issues/39 It's pretty frustrating to not see any docs at all. Thanks in advance. andre -- Andre Klapper | ak...@gmx.net https://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: Volunteering
Hi Damian, On Mon, 2018-06-04 at 14:17 +1000, Damian Weibler wrote: > Hi, I am looking for writing experience and a friend recommended you > to me. I have a degree in creative writing and another in geology and > work as an English language proofreader for scientific journals. > I don't have any experience in coding though, and was wondering if > there was any writing I could do. Thank you for your interest and I am sorry for the belated reply. https://wiki.gnome.org/DocumentationProject/Tasks is probably the best place we can offer if you'd like to get an overview of potential tasks in GNOME documentation to work on. Please don't hesitate to ask if you have any questions! Cheers, andre -- Andre Klapper | ak...@gmx.net https://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: gnome ain't show /mnt/dvdram0/
Hi, On Sat, 2018-06-30 at 18:37 +0300, hahlo wrote: > at the terminal I can: hahlo@hahlo-ThinkPad-T430:~$ nautilus > /mnt/dvdram0/ and it works > but tell in the terminal:"Nautilus-Share-Message: 18:23:49.591: Called > "net usershare info" but it failed: Lapsiprosessin “net” käynnistäminen > epäonnistui (No such file or directory) > Nautilus-Share-Message: 18:25:36.587: Called "net usershare info" but it > failed: Lapsiprosessin “net” käynnistäminen epäonnistui (No such file or > directory) > > (eog:3932): EOG-WARNING **: 18:25:41.960: Tiedoston > ”/home/hahlo/.cache/thumbnails/normal/53ee2f41a7da3ab3244a692c8a1f7e5b.png” > avaus epäonnistui: Tiedostoa tai hakemistoa ei ole" > > is it a bug or feature? Welcome to the documentation mailing list. For general support questions, please ask on the mailing lists, IRC, or in a forum of your distribution and include version information. Thanks! andre -- Andre Klapper | ak...@gmx.net https://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: Page about the Super key
Hi, On Sun, 2018-07-01 at 22:38 +0200, Gunnar Hjalmarsson wrote: > We received the ubuntu bug <https://launchpad.net/bugs/1779547> > about > this page: > > https://help.gnome.org/users/gnome-help/stable/keyboard-key-super.html > > The bug reporter claims that 5 of 5 items are incorrect and/or > insufficient, and from an Ubuntu POV I fear he is right. > > However, I suspect that there may be Ubuntu specific stuff which > complicates it a bit. Therefore it would be great if someone could help > to sort it, so we can decide a proper wording of the page upstream. Then > I'll be happy to submit a pull request. https://help.gnome.org/users/gnome-help/stable/keyboard-key-super.html #1 The activity overview does not open the "Show Application" to then open "Settings" - that's true but I don't understand where it is implied that something like "Show Application" is opened. #2 This is a downstream issue only it seems. #3 is valid, there is no tab and the list is called "Keyboard Shortcuts". #4 is valid - You have to scroll down to "System" in that list and have to find the "Show the activities overview" item in that list. #5 I do not think you can remove the Super key from being a shortcut for the overview at all via Settings. andre -- Andre Klapper | ak...@gmx.net https://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: stable/instable even/odd
On Thu, 2018-06-21 at 19:50 +0200, Дилян Палаузов wrote: > Hello, > > this link says simultaneoulsy atkmm 2.27.1 and atkmm2.24.2 Feel free to file a ticket. > but stays silent about evolution. Evolution is not part of 'core' so it is not listed. > Can you include the link in the documentation about odd/even > versions? If you refer to the link that Rafael posted: Please file a ticket. Cheers, andre -- Andre Klapper | ak...@gmx.net https://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: stable/instable even/odd
Hi, On Thu, 2018-06-21 at 17:59 +0200, Дилян Палаузов wrote: > I would like to compile Gnome manually and for this it would be nice > to know for each package the latest stable version. If you are after compiling the latest stable tarballs manually, ftp://ftp.gnome.org/pub/gnome/teams/releng/3.28.2/versions lists the specific versions for all modules in 3.28.2. Cheers, andre -- Andre Klapper | ak...@gmx.net https://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: stable/instable even/odd
Hi Dilyan, On Thu, 2018-06-21 at 14:50 +, Дилян Палаузов wrote: > That's the point: it is relevant for the most packages, I am asking > which packages at https://download.gnome.org/sources do not follow > this schema. > > I meant all packages at https://download.gnome.org/sources We don't know, I think. By default maintainers are supposed to follow the odd=unstable / even=stable scheme but it's not that the documentation writers had some list. Is there a specific reason why you ask? andre -- Andre Klapper | ak...@gmx.net https://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: gnome-session-quit time
Hi and welcome! On Sun, 2018-04-22 at 00:36 +0200, MS wrote: > If you > click shutdown icon there's a popup saying the computer will shutdown > automatically in 60 seconds. Can you decrease the time? Which problem would get solved by decreasing that time? Thanks, andre -- Andre Klapper | ak...@gmx.net https://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: Latest changes in gnome-user-docs
On Sat, 2018-03-17 at 01:08 +0100, Gunnar Hjalmarsson wrote: > On 2018-03-16 20:48, Mario Blättermann wrote: > > At least, a translator comment should be placed there to avoid > > confusion. > > That would indeed make sense. Is it possible to place such comments in > the Mallard markup code? Whatever the answer is, it should be documented in a Mallard section on https://wiki.gnome.org/TranslationProject/DevGuidelines/Use%20comments andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: Latest changes in gnome-user-docs
On Fri, 2018-03-16 at 20:10 +0100, Mario Blättermann wrote: > while completing the translation of gnome-user-docs, I stumbled upon > this string: > > #. (itstool) path: note/p > #: C/files-preview.page:35 > #, fuzzy > #| msgid "" > #| "Install " > #| "Tweaks" > msgid "" > "Install Sushi "link>" > > The "apt" command is usually only available on Debian based systems. See https://bugzilla.gnome.org/show_bug.cgi?id=794187 for context. https://git.gnome.org/browse/gnome-user-docs/commit/?id=f7bcf724370e237af74f9bdb2839fea30dd25063 shows that it's only shown on Ubuntu systems so I don't see a problem. andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: Feature Freeze break request for nautilus
On Tue, 2018-03-13 at 12:35 -0500, Michael Catanzaro wrote: > It's an usual request, but I agree this makes sense. +1 from me. ...and another +1. andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: build gnome-user-docs with nl included
Hi, On Thu, 2018-03-01 at 11:25 +0100, Hannie Dumoleyn wrote: > What I have done is this: > > Pre-commit checks instructions on [1]: I have built gnome-user-docs > according to these instructions. What I get in the folder > system-admin-guide is C, cs, de, es, gl and ko. > > My question is: why do I only get 5 languages in this build, while I > do > have /nl in /gnome-user-docs/gnome-help. Should I add nl somewhere > (Makefile, Makefile.am or whatever)? Please add "nl" to the variable called "HELP_LINGUAS" at the end of the file "Makefile.am". Thanks!, andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: user-docs Dutch translation
Hi, On Mon, 2018-02-26 at 11:15 +0100, Hannie Dumoleyn wrote: > After having finished gnome-user-docs 3.28 Dutch translation I want > to check it. Can I open a .po file using Yelp? That won't work - Yelp displays help pages, not translation files. :) https://mail.gnome.org/archives/gnome-doc-list/2014-September/msg00075.html explains how to build help files. (Crossing fingers it's still valid.) andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: multi-factor authentication in nautilus
Hi Scott, On Mon, 2018-02-05 at 11:03 -0500, Scott M Smith wrote: > I am using the nautilus file manager (2.28.1) within GNOME 2.28.2, > and I am trying to connect to a remote server that requires > multifactor authentication. I am prompted for an initial password, > followed by a token that I receive via text message. However, after I > input the first password, the file manager never prompts me for the > second (token) key, and I am therefore unable to gain access to the > server. I have been unsuccessful in trying to configure nautilus to > prompt me for this second key. Any assistance with this issue would > be greatly appreciated. The GNOME documentation mailing list is for discussing documentation. As you have a general support question, please feel free to ask your question in a support forum of your distribution if your distribution still supports GNOME 2.28 (which was released nine years ago). Thanks, andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: Conditions not satisfied when converting to HTML
On Mon, 2017-12-11 at 02:51 +0100, Gunnar Hjalmarsson wrote: > The markup code at gs-browse-web.page includes various conditionals. > However, none of the conditions seems to be satisfied when converting to > the HTML version of the page: > > https://help.gnome.org/users/gnome-help/stable/gs-browse-web.html > > When browsing gs-browse-web.page using yelp it seems to be correctly > rendered, though. > > I don't know where the problem lies. How could the software running behind help.gnome.org know on which exact Linux distribution the user's browser is running? :) I guess it could check the browser's user agent string. Does e.g. Ubuntu patch all the browsers shipped in Ubuntu to include some special "Ubuntu" line in the browsers' user agent strings? If that's the case you could file an enhancement request: https://bugzilla.gnome.org/enter_bug.cgi?product=website andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: Change .page, see result
Hi, On Mon, 2017-12-04 at 17:59 +0100, Hannie Dumoleyn wrote: > When I add .page to the command > ~/gnome/gnome-getting-started$ yelp gs-use-system-search.page > I get: unknown error. If that is a standard Git checkout, then there is simply no file called "gs-use-system-search.page" in the top folder of "gnome-getting- started". Hence Yelp cannot offer files that do not exist. > I do not know where the help files which I get when I press F1 > reside, Pressing "Ctrl+L" in Yelp will tell you the location. :) andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: Change .page, see result
On Mon, 2017-12-04 at 11:56 +0100, Hannie Dumoleyn wrote: > I would like to know how I can see the result of the changes I make to a > .page file You open the .page file in Yelp (GNOME's help browser). Cheers, andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: String Freeze break for Tweaks
On Sun, 2017-09-10 at 10:15 -0500, Michael Catanzaro wrote: > I'll give +1 of 2 from release team, since this string won't be > visible > except in Ubuntu anyway. You'll also need two +1s from translation > team. r-t approval 2/2 to get the string in right after 3.26.0, for 3.26.1. andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: UI/hardcode freeze break request for GNOME Shell
On Fri, 2017-09-08 at 16:31 +0100, Allan Day wrote: > This is a break request that changes some visual styling in GNOME > shell. The code changes are deliberately minimal. However, the visual > change is noticeable. > > The design team recognise that it is late in the cycle but we'd be > unhappy putting the release out in its current state. > > The bug containing the patch: > https://bugzilla.gnome.org/show_bug.cgi?id=787446 Fine with me if the docs team is okay with this (screenshots). andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: SELinux is preventing abrt-hook-ccpp from getattr access on the file file.
Hi Ahmad, On Thu, 2017-09-07 at 23:12 +0500, Ahmad Usman wrote: > SELinux is preventing abrt-hook-ccpp from getattr access on the file > file. Feel free to file a bug report against your distribution and/or bring this up in a discussion forum of your distribution. Neither SELinux nor abrt are part of GNOME, and this is not related to GNOME documentation. :) Cheers, andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: Fwd: UI freeze exception
Hi, On Thu, 2017-08-24 at 19:27 +0100, Alexandru Pandelea wrote: > This summer we have worked on implementing favorite files in > Nautilus, using the nao:predefined-tag-favorite tag to store this > information in the Tracker database. > > The UI added consists of a new item in the sidebar, called 'Starred' > which shows the favorite files. This sidebar item will also be > visible in the filechooser. Apart from this, a new column has been > added in the list view, which shows a star for which row that can be > toggled to make/unmake files favorite. Also, for the canvas view, or > to star/unstar multiple files at once, an action was added in the > context menu. > > This are the bugs with the code related to this changes: > https://bugzilla.gnome.org/show_bug.cgi?id=786039 > https://bugzilla.gnome.org/show_bug.cgi?id=785176 > https://bugzilla.gnome.org/show_bug.cgi?id=786367 > > Here are screenshots of how the new UI looks like: > > We tested this new changes and though there are minor changes to be > made, this feature works well and it is also expected by users, so > this is why I believe it should be included in this release. As UI and feature freeze were 17 days ago and as we are also past string freeze (your proposed changes also contain new strings) and as we're talking about more than 2000 lines of code here, I will not give my release-team approval. It feels too late for 3.26. I'm aware that the GSoC and Outreachy schedules only provide a short integration time window and that this can be demotivating when you have to wait six months longer until your changes are available to users. Having stability in mind, I would prefer if these changes received broader testing and I'd also like to allow those "minor changes" you mention to be incorporated (in early 3.27.x). I'm looking forward to seeing this functionality included in 3.28. Other r-t members are free to have different opinions of course. :) andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: string freeze break request for Characters
Hi, On Thu, 2017-08-24 at 10:09 +0200, Daiki Ueno wrote: > Thank you, so I am copying the docs team and release-team now. Would > this UI change be acceptable? > > Regards, Erm, replying to a top-post removes everything below the signature. For future reference, could you avoid top-posting please? :) Manually quoting your email: > For better support for Emoji in 3.26, we would like to reorganize the > categories in Characters: > https://bugzilla.gnome.org/show_bug.cgi?id=764792 > That would require the following string additions: > "Emojis" > "Letters & Symbols" > "Smileys & People" > "Animals & Nature" > "Food & Drink" > "Activities" > "Travel & Places" > "Objects" > "Symbols" > "Flags" > "Recently Used" > "Recently Used %s Character List" I don't see a patch to review. Also, the last string might welcome https://wiki.gnome.org/TranslationProject/DevGuidelines/Use%20comments as I do not know what %s is. Thanks, andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: Proposal: GNOME Docs String Freeze
On Wed, 2017-05-31 at 07:41 -0400, Jeremy Bicha wrote: > On Wed, May 31, 2017 at 7:22 AM, Paul Cutler <pcut...@gnome.org> wrote: > > FWIW, I agree with Andre that it's better to have correct documentation > > shipped than incorrect with translations. I know this last cycle, I was > > fixing bugs right up until the release, which I know can be frustrating for > > translators, but we had some old bugs I could fix. > > All of GNOME has bugs. With this proposal, you can still fix bugs at > any time in master but some bugfixes are just too late to be shipped > to stable distros immediately. Regarding bugs in code, we have a hard code freeze before a .0 release - you'd need to ask the release-team for a freeze break if you consider the bug and your bugfix important enough to be potentially included. > I mean if a distro absolutely does not care about translations, they > are welcome to cherry-pick commits from master or even ship git > snapshots of master, but I doubt Ubuntu is the only distro that will > benefit from more completely translated user help. I think we all care about translations. However, translating text which is known to be wrong (and hence will get changed soon anyway and hence needs to get re-translated) does not sound like the best use of translators' time. That's a different situation than fixing code. Apart from a nice looking number in press releases, I don't see much sense in "100% translated user help in XY languages" if the translated user help actually helps no users because its content is known to be wrong. I'd say it helps more users if the user help is correct but not yet translated, as at least some users might understand English. (I admit I also believe in "Better to have no docs than wrong docs".) andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: Proposal: GNOME Docs String Freeze
On Wed, 2017-05-31 at 02:14 +0200, Gunnar Hjalmarsson wrote: > On 2017-05-30 23:10, Andre Klapper wrote: > > My understanding is that the currently non-existing documentation > > string freeze is a result of missing (wo)manpower and the tight > > release schedule. Assuming that any "late" changes are actual bug > > fixes and not cosmetic changes (please correct me if I'm wrong), I'd > > prefer correct documentation in English to incorrect (but translated) > > documentation. > > Due to a lack of manpower it will never be perfect, of course, and the > later a change is made, the greater is the risk that all the translator > teams won't catch up. But isn't it somewhat contradictory to ship > 'translated' docs with strings which the translators have not even had a > fair *chance* to translate? Of course that's something to avoid - that's why I differentiated between cosmetic late changes and late bug fixes. As long as there are not so many people working on our docs, shipping incorrect (but translated) docs to users sounds worse to me than shipping correct English docs. Would you disagree with this? (Many things feel contradictory when there are limited resources. I don't think that's avoidable. If we had way less translators, would we discuss an earlier string freeze so translators have more time?) > I for one see Jeremy's proposal as a reasonable step in the right direction. I'd also agree with Jeremy, //once GNOME had way more people working on docs//. andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: Proposal: GNOME Docs String Freeze
Hi, replies inline. On Tue, 2017-05-30 at 16:03 -0400, Jeremy Bicha wrote: > The Ubuntu Docs team currently intends to ship gnome-user-docs in the > Ubuntu 17.10 default install with a minimal "overlay" to keep a few > Ubuntu-specific customizations in the separate package ubuntu-docs. > Furthermore, the Ubuntu Docs team intends to ship the GNOME > translations for gnome-user-docs. I see one issue: Ubuntu tries not to > break translations when providing stable release updates. > > Specific example (but I don't intend to criticize anybody here): > gnome-user-docs 3.24.0 had a string change about an hour and a half > before the tarball was released, which was not enough time for any > language to get translations for that string. More changes were made > after that point but there was not much translating done before 3.24.2 > > My understanding of why GNOME doesn't have a docs string freeze is > that to some extent, the UI needs to be frozen for docs to be > finalized. Also, we don't want to put arbitrary roadblocks in the way > of anyone making great contributions to our docs. My understanding is that the currently non-existing documentation string freeze is a result of missing (wo)manpower and the tight release schedule. Assuming that any "late" changes are actual bug fixes and not cosmetic changes (please correct me if I'm wrong), I'd prefer correct documentation in English to incorrect (but translated) documentation. > Proposed gnome-user-docs schedule for GNOME 3.26 > > 1. Docs String Freeze at the GNOME 3.26.0 release. At that point, a > gnome-user-docs tarball would be released and the gnome-user-docs git > repo branched for gnome-3-26. Any new string changes can go to the > master branch. > 2. gnome-user-docs tarball release for 3.26.1 and .2. The 3.26.1 > release should be on time for it to be included in Ubuntu 17.10, > assuming Ubuntu 17.10 goes with GNOME 3.26. Not sure if I understand correctly, but if no string changes should happen after the 3.26.0 release, why release tarballs for .1 and .2 if they would not include changes? Cheers, andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: gnome-online-accounts: String freeze break request (GNOME #778416, #778417)
On Wed, 2017-03-15 at 19:33 +0100, Alexandre Franke wrote: > On Wed, Mar 15, 2017 at 7:18 PM, Michael Catanzaro <mcatanzaro@gnome. > org> wrote: > > On Wed, 2017-03-15 at 17:46 +, Debarshi Ray wrote: > > > What do you think? > > > > +1 of 2 from release team. Remember you need two more +1s from > > translation team. > > Here is one of the two. r-t approval 2 of 2 (as this makes a lot of sense). andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: gnome terminal question?
On Tue, 2016-09-20 at 13:23 -0700, Jake wrote: > if anyone can suggest a way that I can change this, or a "todo" list > where I can suggest it to be done, I appreciate the referral. https://bugzilla.gnome.org/enter_bug.cgi?product=gnome-terminal=general=3.18.x=keynav Thanks, andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: gnome terminal question?
Hi Jake, On Mon, 2016-09-19 at 13:23 -0700, Jake wrote: > Hi, i'm using gnome-terminal version 3.18.3 in Linux Mint 18 > (cinnamon) > > and i'm trying to figure out how to enable hotkeys on the right-click menu > > in gnome-terminal 3.6.2 (linux mint 17.1) i can do right-click (on a URL) > and then press the O key (on the keyboard) to choose "open URL" > > but in gnome-terminal 3.18.3 (linux mint 18) if i right-click (on a URL) > there are no key assignments to the menu, and pressing O (or any other > letter) does nothing. I would have to move the mouse or use the arrow > keys and press ENTER. > > can anyone help me figure out what's wrong? I don't understand why the > hotkeys disappeared. See https://help.gnome.org/users/gnome-terminal/stable/adv-keyboard-shortcuts.html Thanks, andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: gnome terminal question?
Hi Jake, On Mon, 2016-09-19 at 13:23 -0700, Jake wrote: > Hi, i'm using gnome-terminal version 3.18.3 in Linux Mint 18 > (cinnamon) > > and i'm trying to figure out how to enable hotkeys on the right-click menu > > in gnome-terminal 3.6.2 (linux mint 17.1) i can do right-click (on a URL) > and then press the O key (on the keyboard) to choose "open URL" > > but in gnome-terminal 3.18.3 (linux mint 18) if i right-click (on a URL) > there are no key assignments to the menu, and pressing O (or any other > letter) does nothing. I would have to move the mouse or use the arrow > keys and press ENTER. > > can anyone help me figure out what's wrong? I don't understand why the > hotkeys disappeared. See https://help.gnome.org/users/gnome-terminal/stable/adv-keyboard-shortcuts.html Thanks, andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: Freeze break request for polari
[Indicating the specific freeze(s) in the subject is generally welcome] Regarding Feature and UI Freeze, release-team approval 1 out of 2. andre On Mon, 2016-08-29 at 13:33 +, Florian Müllner wrote: > Hey folks, > > I'd like to land support for NickServ passwords (https://bugzilla.gno > me.org/show_bug.cgi?id=709982) in 3.22. This is a much anticipated > feature that required quite a bit of code shuffling (thus the longer > review process), though the actual impact on the UI is quite minor: > When we detect that the user writes a (private) "identify" message, > we display an InfoBar to offer saving the entered password. If the > conversation is currently not visible (for instance when using the > /msg command), we also display a notification for the same purpose. > > Both cases are strict additions that are displayed in response to > user action, not modification of existing elements, so the change has > no effect on screenshots/documentation. > > There are a couple of string additions though: > - a description to identify the saved password in gnome-keyring > ("Polari NickServ password for FreeNode") > - the infobar title ("Should the password be saved?"), subtitle > ("Identification will happen automatically the next time you > connect to GNOME") > and button ("_Save Password") > - the notification title ("Save NickServ password for GNOME?") and > body > (same as infobar subtitle) and button ("Save") > > The feature is available on the wip/fmuellner/nickserv branch, which > is fairly well-tested by now as all changes during the last month > have been minor fixes that came up during review. > > Cheers, > Florian > _______ > release-t...@gnome.org > https://mail.gnome.org/mailman/listinfo/release-team > Release-team lurker? Do NOT participate in discussions. -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: UI freeze exception
On Sun, 2016-08-28 at 15:42 +0200, Frederic Peters wrote: > > We have been working on GSoC for batch renaming project for Nautilus. We > > just finished on making sure the experience is great and I would like to > > ask for a UI freeze exception to include it in the 3.22 release. > > I'll give the first required approval but it *must* be part of > 3.21.91, to be published tomorrow. r-t approval 2 of 2. And what Fred wrote. andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: Contribution a language definitions file
Hi Fernand, On Thu, 2016-04-21 at 15:23 -0400, Fernand Veilleux wrote: > I wrote a new ngc.lang and corresponding style scheme for gcode I > want to contribute. Thanks for doing that! > I read : "If you have written a language definition for GtkSourceView > and you would like to share it with other users, please list it here, > including the .lang file." > > Would you please indicate where to find how to do it ? Where exactly did you read that? Any URL / link? I'd hope that the "here" would be a link. If not, let's fix that. :) andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: Workshop at GNOME.Asia 2016
On Mon, 2016-04-18 at 10:51 +0530, Aruna S wrote: > Just confirming: This is 8.30-10.30 **a.m.** IST right? It is 09:00-11:00 a.m. IST (03:30-05:30 a.m. UTC) as per http://2016.gnome.asia/schedule/ Cheers, andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: Workshop at GNOME.Asia 2016
Correction: Date below should be April 21 instead of April 28. :) andre On Fri, 2016-04-08 at 10:31 +0100, Ekaterina Gerasimova wrote: > Hi all, > > as for the last 2 years, I've submitted a workshop for GNOME.Asia. > This year I'm thinking of using an app without any docs for the > workshop and getting people to write some new pages. I'm going to > bring a bunch of GNOME continuous images with me and ask people to > have gnome-boxes or VirtualBox installed beforehand rather than > faffing about with sharing some up-to-date machine for demos or > building the app themselves. > > I would like to use gnome-maps, but if anyone has other suggestions > of > something better that comes with GNOME Continuous, please let me > know. > > Can I have a show of hands for people who will be at GNOME.Asia in > person on the 28th of April to help out with the workshop? And those > of you who are willing to be awake at 3:30-5:30 UTC for remote > support > on IRC and Bugzilla? > > For time zone checks, please feel free to use > http://www.worldtimebuddy.com/?qm=1=30,100=30=2016-4-8 > =9-11 > > > Thanks > Kat > ___ > gnome-doc-list mailing list > gnome-doc-list@gnome.org > https://mail.gnome.org/mailman/listinfo/gnome-doc-list -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: gnome-photos: Tweaking the list of crop presets (GNOME #762942)
On Thu, 2016-03-03 at 15:48 +, Debarshi Ray wrote: > I would like to land this patch that tweaks the list of crop presets: > https://bugzilla.gnome.org/show_bug.cgi?id=762942 > > It removes the actual aspect ratio string (ie. "%.2f") from the UI, > and changes the list of human readable names (see the screenshots). > > I am sorry about the late change but we went back and forth on the > list > multiple times in #gnome-design, and it took us a while to settle on > something. > > Editing is a new feature this cycle, so I don't think it affects any > documentation. Fine with me; r-t approval 1 of 2. andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: Freeze exception request for Maps, editting of address
On Thu, 2016-02-25 at 15:25 -0500, Matthias Clasen wrote: > This looks good to me, +1 for the release team. Thanks for listing > the new strings too r-t approval 2 of 2. And thanks for the translator comment! (/me wonders if there are any docs for Maps as doc-list is CC'ed) andre > On Thu, Feb 25, 2016 at 1:57 PM, Jonas Danielsson wrote: > > I would like to request a UI freeze exception for editting of > > address > > on OpenStreetMap in Maps. > > > > This is useful for instance when you want to add a house number for a > > building, or for correcting postal codes, maybe? Also really useful > > when adding new nodes to OpenStreetMap through Maps. > > > > The bug is here: > > https://bugzilla.gnome.org/show_bug.cgi?id=762591 > > > > And a cast of the functionality here: > > https://bug762591.bugzilla-attachments.gnome.org/attachment.cgi?id=322406 > > > > > > New string in this patch: > > Street > > House number > > Postal code > > City > > > > Thanks! > > Jonas > > ___ > > release-t...@gnome.org > > https://mail.gnome.org/mailman/listinfo/release-team > > Release-team lurker? Do NOT participate in discussions. > ___ > gnome-i18n mailing list > gnome-i...@gnome.org > https://mail.gnome.org/mailman/listinfo/gnome-i18n -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: [Evolution] UI/Feature freeze break approval plea for 3.19.91; string additions
On Mon, 2016-02-22 at 07:50 -0500, Matthias Clasen wrote: > On Fri, Feb 19, 2016 at 12:36 PM, Milan Crha wrote: > > > > I'd like to ask for a Feature Freeze break approval, together with a UI > > Freeze break approval and, if accepted, I'd also announce a new strings > > in the evolution, all for bug [761301], which adds an option to "Create > > events, memos and tasks as Private by default" (that's also the added > > string, once with a mnemonic, another time without it). The option can > > be found in Edit->Preferences->Calendar and Tasks->General tab, in a > > newly added section Miscellaneous, as the last section there. > > > > It's pretty simple change in the code, and UI, but can improve > > usability for users where privacy of this kind matters. > > > > Thanks and bye, > > Milan > > > > [761301] https://bugzilla.gnome.org/show_bug.cgi?id=761301 > +1 for the release team. Approval 2 of 2 from release-team. I guess for Evolution I can also give the docs approval. Hence please go ahead. :) andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: Evolution Quickstart guide
Hi Dan, On Wed, 2015-10-07 at 20:57 +0100, Dan MacDonald wrote: > I have written a quickstart guide at work for configuring Evolution & > EWS to access mail, calendars and contacts from our companies > Exchange server. It also covers configuring your signature and > dealing with proxies etc. With a bit of tweaking I could make it into > a more generic guide for achieving this that could be added to the > official Evolution docs if you're interested? Thanks for your interest! Evolution's EWS documentation is rather limited. I don't have access to an EWS account so help, ideas and improvements are welcome! https://help.gnome.org/users/evolution/3.18/intro-first-run.html embeds a "Exchange EWS" section which basically comes from https://help.gnome.org/users/evolution/3.18/mail-account-manage-microsoft-exchange.html Configuring signatures is under https://help.gnome.org/users/evolution/3.18/mail-composer-mail-signatures.html and I have no idea if we properly cover setting up proxies. If you want to play with the existing docs directly: The files in Mallard format are located in Git under /help/C/ in https://git.gnome.org/browse/evolution/ To check out from Git, see https://wiki.gnome.org/Git/Developers#Anonymous_Access and to get the local files displayed, you can execute $> yelp . from the command line in the checked-out /help/C/ folder. General GNOME documentation info is available under https://wiki.gnome.org/DocumentationProject Hope that helps a bit? :) Don't hesitate to ask questions! Cheers, andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: GNOME Calculator: UI freeze exception request (#707459)
On Sun, 2015-09-20 at 19:12 +0200, Frederic Peters wrote: > Alberto Ruiz wrote: > > I recently got a fix for GNOME Calculator's bug #707459 that made several > > dialogs look way larger than they should have. I assume this was a > > regression at some point during some of the changes experienced by Gtk+. > > > > Matthias Clasen has submitted a patch to fix the .ui file in this regard > > and get the dialogs back to normal. This is already in master (I branched > > gnome-3-18 already). > > > > This change has no layout changes just window sizing, and given how utterly > > ugly the dialogs were before the patch I'm assuming this should have no > > effect on the documentation or any other screenshot releated work. > > Fine by me. > Fred ...and another +1 from r-t. No images listed on https://l10n.gnome.org/module/gnome-calculator/ so should also be fine with docs. andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: UI freeze exception
On Tue, 2015-09-01 at 15:57 -0400, Carlos Soriano Sanchez wrote: > Even if it is late, I would like to ask for an UI freeze exception > for https://bugzilla.gnome.org/show_bug.cgi?id=725939 > The reason is that GtkFileChooser implemented it, but nautilus > didn't. One of the points for 3.18 was to make consistent > the behavior between GtkFileChooser and Nautilus, and this is the > last important item remaining. > > Basically it adds an action bar when a search is performed in some > remote location, indicating the user that the search is > being done non recursively. Here a screenshot: Makes sense so this is one r-t approval. andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: Freeze break request for gnome-control-center (printers) UI changes, bug #690351
Hi Felipe, *if* you'd like to request a UI freeze break request you need to contact the release-team. See https://wiki.gnome.org/ThreePointSeventeen or https://wiki.gnome.org/ReleasePlanning/Freezes#UI_Freeze But I have no idea yet if this actually is a UI change. The email subject mentions UI changes, the body new strings. Cheers, andre On Fri, 2015-08-28 at 16:29 +0200, Felipe Borges wrote: Hi, We have updated gnome-control-centers Printers' panel in order to fit the new designs. These changes have included two new strings. https://bugzilla.gnome.org/show_bug.cgi?id=690351 Since it's an old bug and makes Printers way more presentable while empty (no printers), I hope we can make this exception. Thanks, Felipe. ___ gnome-i18n mailing list gnome-i...@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-i18n -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: What is the difference between a Gnome app and a Gnome project?
On Tue, 2015-08-04 at 12:21 +, Rakhee wrote: I was going through GNOME website, and I see two lists: Apps and Projects https://wiki.gnome.org/Apps https://wiki.gnome.org/Projects What is the difference between Gnome apps and projects? Simplified answer: Applications have user interfaces and often depend on functionality in libraries / projects which are lower in the stack. andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: Work in progress documentation design
On Tue, 2015-07-28 at 16:17 +0100, Allan Day wrote: Keeping the videos up to date is considerably more work than maintaining static SVGs. If I interpret that correctly: If the videos received more maintenance there'd be no reason to potentially remove them, but there's no problem with having those videos (size, content, etc) per se. And as time goes on, getting started isn't as important as it used to be. Could you explain what data this statement is based on? Testing with new users? Something else? andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: gnome-online-accounts: Freeze break request for bug 746540
On Fri, 2015-03-20 at 18:05 -0400, Matthias Clasen wrote: On Fri, Mar 20, 2015 at 3:33 PM, Debarshi Ray rishi...@lostca.se wrote: Hey, I would like to break the hard code freeze to add some spacing between the service name and its switch: https://bugzilla.gnome.org/show_bug.cgi?id=746540 Screenshots and the patch are on the bug. Strikes me as a cosmetic fix that could easily wait for .1. But given that the patch is entirely harmless, and I've been annoyed by this very bug myself, I'll give a +1 to letting it in now. Safe; r-t approval 2 of 2; plus I hope I'm right that I could not find any affected screenshot in the user docs. andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: g-t-t UI and string freeze break request - bug 711536
On Mon, 2015-03-16 at 17:46 -0400, Matthias Clasen wrote: On Mon, Mar 16, 2015 at 1:34 PM, Rui Tiago Cação Matos tiagoma...@gmail.com wrote: Hi, I'd like to push the patch in https://bugzilla.gnome.org/show_bug.cgi?id=711536 . It's trivial but adds a new switch button and a translatable string. +1 for the release team. And a 2nd approval from r-t... Now waiting for another i18n approval, I think. andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: String/UI freeze request for gnome-shell
On Fri, 2015-03-13 at 08:28 -0400, Matthias Clasen wrote: On Fri, Mar 13, 2015 at 6:39 AM, Florian Müllner fmuell...@gnome.org wrote: Hey, I would like to request a freeze break for https://bugzilla.gnome.org/show_bug.cgi?id=746022. The patches there will make the legacy status icon tray that appeared in 3.15.91 accessible to keyboard navigation, by adding an appropriate entry in the ctrl-alt-tab popup. They also add the following strings: - Status icons: the label of the additional item in the popup - Hide tray: the accessible name of the [] button which hides the legacy tray again +1 for the release team Approval 2 out of 2 from r-t. Though I wonder if a translator comment for Hide tray could be helpful (Translators: 'Hide' is a verb). https://wiki.gnome.org/TranslationProject/DevGuidelines/Use%20comments andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: String freeze break for gnome-photos
On Tue, 2015-03-10 at 21:25 +0530, Pranav Kant wrote: Here is the bug[1] to fix delete notifications [1] https://bugzilla.gnome.org/show_bug.cgi?id=745756 Patch has been marked as needs-work. Once it's been accepted by maintainer, please ping. andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: [gnome-boxes] (3 commits) Created branch gnome-3-17
On Wed, 2015-03-04 at 19:26 +, Lasse Schuirmann wrote: The branch 'gnome-3-17' was created. As per https://wiki.gnome.org/MaintainersCorner this should probably be named gnome-3-18 instead. andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: Boxes: UI freeze break request
On Mon, 2015-03-02 at 08:10 -0500, Matthias Clasen wrote: +1 for the release team from me. And another +1 from the release team. andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: [evolution] Plea to break UI freeze
On Tue, 2015-02-17 at 15:39 +0100, Milan Crha wrote: Hello, I'd like to break UI freeze for contributors' patches at [1][2][3]. +1 *if* bug reports exist to update the user documentation. andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Help/Docs components in GNOME Bugzilla (again)
Morn. One year ago I brought up make it easier to find documentation tickets in Bugzilla [1] on gnome-doc-list@. And gave up because it was a mess. But expecting folks (not: reporters who might not know) to manually set the assignee to default QA contact of gnome-user-docs-ma...@gnome.bugs or gnome-devel-docs-ma...@gnome.bugs isn't convincing either. When it comes to developer AND user documentation in Bugzilla's {Bindings, Core, Platform, Applications} classifications, those products that have dedicated components show this variety of component names: * doc (1 product) * documentation (36) * Documentation (16) * docs (22) * API documentation (1) * Developer documentation (1) * user-docs (1) * user docs (1) * User docs (1) * User documentation (1) * User Documentation (1) * User Guide (1) Does the Doc team know if some products have both dev and user doc tickets in the very same component? I'm still wondering whether it makes sense to standardize the name. I'm happy to push this and bring it upon d-d-l, but this will take a while and need help, because: MUST identify for each Bugzilla product if the component is about dev or user docs before renaming. Or if it's both, someone needs to triage those items first (potentially needs help). Intentionally not covered in this posting: That Bugzilla keyword called documentation. Cheers, andre [1] https://mail.gnome.org/archives/gnome-doc-list/2014-January/msg3.html -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: Old manual versions that lack licenses
On Mon, 2015-01-19 at 22:17 -0500, Richard Stallman wrote: The rewritten version is at https://help.gnome.org/users/baobab/3.14/ and licensed as CC by-sa. It's not good for a GNU manual converted to a non-GNU license. The GNOME Desktop System Administration Guide is in the same situation, with oldest version as GFDL and available here: https://help.gnome.org/admin/system-admin-guide/2.32/index-info.html and newest version as CC by-sa and online here: https://help.gnome.org/admin/system-admin-guide/3.14/ It looks like this is a systematic trend, and it might get worse.n Do you know who is responsible? What can we do about it? The reasons for CC-BY-SA as default are given on https://wiki.gnome.org/DocumentationProject/Guide/Licensing Cheers, andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: error while using brightness function
On Tue, 2014-11-11 at 20:59 +0530, Abhishek Gautam wrote: hi fedora team, You sent an email to the GNOME documentation mailing list. If you would like to contact the Fedora team, please contact the Fedora team. :) Thanks, andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: Next (winter) docs hackfest?
On Mon, 2014-09-29 at 17:28 +0100, Ekaterina Gerasimova wrote: That would make the hackfest dates sometime around 24th-29th of January. I won't make it to that hackfest - business trip collides. But I'll be at FOSDEM on Jan31/Feb01 giving random talks! andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: UI freeze break request for Yelp
On Thu, 2014-09-11 at 17:36 +0200, Frederic Peters wrote: I would like to request a UI freeze break request for Yelp. Shaun has approved the patch: https://bugzilla.gnome.org/show_bug.cgi?id=736408#c9 https://bug736408.bugzilla-attachments.gnome.org/attachment.cgi?id=285837 The change adds border styling to the find bar in Yelp, to make it match the find bar in gedit. Without the patch, the find bar appears to float over the content, so it would be a nice bit of polish to get the change in. (...) Here's your first release team approval. Fred Second r-t approval. andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: Request for UI freeze break
On Thu, 2014-09-04 at 10:41 -0400, Ondrej Holy wrote: I'd like to request UI freeze break for the Gnome Control Center to fix wrong padding in the User accounts panel. Patches are attached in the Bug 736009: https://bugzilla.gnome.org/show_bug.cgi?id=736009 The UI change is shown in a screenshot: https://bug736009.bugzilla-attachments.gnome.org/attachment.cgi?id=285311 Looks good to me (r-t approval 1 of 2). I cannot find any affected screenshots in the user documentation (documentation team: please correct me if I'm wrong). andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: Freeze exceptions for gnome-maps
On Sun, 2014-08-24 at 13:04 -0300, Damián Nohales wrote: There is another feature part of GSoC that I want to propose to the freeze exception For future reference, separate emails for separate requests are very recommended. The thread feels already noisy to me (which might decrease your chances to get replies). which is the ability to check-in in Facebook and Foursquare, this also comes with an exception for gnome-online-accounts, for the inclusion of Foursquare backend, there were some communication issues between us which avoid to create the official GNOME Foursquare application in time. How much has this new check-in functionality received testing, and by how many people? Was this developed in a separate branch, or were the basics for this functionality already included in previous 3.13.x tarballs? The bugs in BZ are: gnome-maps: Add Check-In feature https://bugzilla.gnome.org/show_bug.cgi?id=731113 This one adds about 27 new translatable strings (some are optionals, which are name and descriptions of new GSettings options) gnome-online-accounts: Add Foursquare support https://bugzilla.gnome.org/show_bug.cgi?id=729837 The patches have not received any reviews yet by another pair of eyes. Personally I'd expect them to be in accepted-commit_after_freeze status after another maintainer's review, before r-t takes a look. andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: help
Hi Shahin, On Mon, 2014-08-18 at 17:41 +0430, Shahin Mehraban wrote: plase help me for terminal for everything Could you please elaborate? It's hard to help when you ask for everything. Specific questions are easier to answer and more effective - http://catb.org/~esr/faqs/smart-questions.html might be helpful. Thanks, andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: help
On Tue, 2014-08-19 at 16:30 -0300, Rafael Ferreira wrote: Doesn't this look like a spam? It is not the first email without meaning. Maybe. Who knows? Still if somebody really needs some help with the terminal, I prefer to redirect folks to appropriate places once it's clear what's being asked for, instead of assuming it's spam. (And after seeing some more interesting posts here I wondered if it's just feedback from help.gnome.org but that should have mentioned the URL in the summary line.) andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: need help
Hi Junel, On Thu, 2014-07-31 at 09:26 +0800, Junel Mata wrote: how to get the value returned by zenity --question?because i tried to print its value and it returns nothing.asking for help. Please ask on https://mail.gnome.org/mailman/listinfo/gnome-love as the documentation mailing list is for discussion user and developer documentation. Thanks, andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: Feedback on users/empathy/3.12/create-account.page
Hi, unfortunately, your email was entirely empty. Could you try to resend it so it will include your actual feedback? Thanks in advance, andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: Feedback from the website
On Fri, 2014-08-01 at 16:22 +0200, Ekaterina Gerasimova wrote: Hi all, Fred has kindly implemented a simple way to collect feedback from the website by adding a mailto: link to the bottom of every page. The emails currently go to docs-feedb...@gnome.org which is a mailing list. Sorry about the couple of emails that went to d...@gnome.org! Oh, nice. So I probably should stop to tell everybody by default to file a ticket in Bugzilla instead. ;) Mozilla has Was this page helpful and correct? [yes] / [no] buttons at the bottom and a database framework behind. Whenever the no percentage suddenly increases a lot for a certain help page, it's interpreted as a sign that this help page is incorrect and needs updating. But I guess GNOME does not have high enough user and pageview numbers worth to try that... andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
[OT] Re: Feedback from the website
On Fri, 2014-08-01 at 16:39 +0200, Andre Klapper wrote: Oh, nice. So I probably should stop to tell everybody On some days my English is horrible. Make that stop telling. andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: [evolution-data-server] String/UI freeze break approval plea for 3.12.x branch
On Tue, 2014-05-20 at 09:30 -0400, Matthias Clasen wrote: If the translators are on board, I don't see any reason to oppose it: approval 1 for the release team Approval 2 of 2 for r-t. Milan: For user docs, please file a bug report what to update in https://help.gnome.org/users/evolution/3.12/mail-receiving-options-imap-plus.html (if needed) and I'll give my +1 for the user docs too. andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: Hard code freeze break for GNOME Photos
On Sat, 2014-03-22 at 03:41 +0530, Aruna S wrote: The following two patches need to be considered for the freeze break: Patch to include the Help button in the UI, this introduces a UI Change https://bug711505.bugzilla-attachments.gnome.org/attachment.cgi?id=272596 Patch that contains translations of the _Help string in all the languages that Photos is translated to currently: https://bug711505.bugzilla-attachments.gnome.org/attachment.cgi?id=272597 With my release-team hat on I will not give this a +1 for 3.12.0. (Anybody is free to overrule me, of course.) We are now about 72 hours away from 3.12.0 tarball creation. The proposed commit touches packaging and is a functionality enhancement (in contrast to e.g. a crasher bugfix). And after merging this patch, the help git branch of gnome-photos would still have to get merged. I would love to see this included for 3.12.1 though, if translators are okay with the one new string (_Help) which can be taken from existing GTK+ translations, as in above patch by Aruna. andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: Shell strings code freeze break
On Thu, 2014-03-20 at 17:24 +, Zeeshan Ali (Khattak) wrote: Although I realize that its very late to ask for this but if its at all possible, we'd like to ask for a string freeze break and also code freeze break for improving the location setting strings in gnome-shell: https://bugzilla.gnome.org/show_bug.cgi?id=726498 New strings are: Enable Disable In Use But I also see Enabled and Disabled in the patch? andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: control-center UI freeze break
Removing gnome-i...@gnome.org from CC - no strings involved. CC'ing gnome-doc-list@gnome.org as this mentions screenshots... On Thu, 2014-03-13 at 14:43 +, Richard Hughes wrote: I've pushed a patch to gnome-control-center disabling the software usage entry from the privacy panel. Allan asked me to do this, and other members of the release team were not happy with certain legal issues. The bug is here: https://bugzilla.gnome.org/show_bug.cgi?id=726234 Sorry to not ask before pushing, but I figured anything to do with legal would get an automatic +1 from the RT. The only thing that is affected is that some screenshots might have to be retaken. Hopefully the software install tracking can be re-enabled in 3.14 once we've sorted out the translation, privacy and legal issues. +1. andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
GNOME.Asia: Documentation talk?
Hola docs posse, does anybody else also plan to hand in a proposal about contributing to GNOME Documentation for GNOME.Asia conference in Beijing (PRC) in May? https://mail.gnome.org/archives/foundation-list/2014-February/msg00018.html I plan to, but I don't want to duplicate efforts. :) I plan to improve / refresh my slides at https://people.gnome.org/~aklapper/gnome-asia2012/Contributing_To-Gnome_Documentation.pdf I want to also cover gimmicks (yelp check; XInclude; Ctrl+L to see the file name in Yelp) and ways to run the latest version of the application you want to cover in your documentation. Probably way more stuff is missing in these slides worth to mention and helpful for new starters, so I encourage new documentation writers here to share their experience: What would you have wished to had known when you started working on GNOME docs?, to take Lydia's words from http://open-advice.org/ ? Three cheers! andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: Privacy settings entries in GNOME help
On Mon, 2014-02-10 at 19:01 +, David King wrote: Even though those pages are not installed any more, the old translations will still be in the .po files until a translator removes them. I am not a translator, so not sure of the exact process behind the removal (I think that it involves running make repo and then committing the resulting .po file for your language, but I am not sure). Correct. The old translations remain but are commented out. It's basically a poor man's translation memory for that translation and application only and would be picked up again once the English string was reintroduced. andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: Translations inside of SVG files
On Wed, 2014-02-05 at 15:58 +0100, Frederic Peters wrote: Andre Klapper wrote: On Sun, 2014-02-02 at 08:51 +0100, Frederic Peters wrote: Actually we already have some translated SVGs in the current Getting Started documentation. It doesn't use the systemLanguage attribute, they're just considered as XML files and itstool does the job of extracting strings to a po file, and merging them back, creating one SVG file per language. An example is here: https://help.gnome.org/users/gnome-help/3.10/gs-goa3.svg.es It's not perfect as it duplicates the files, and it currently requires the SVG files to be declared in HELP_FILES and be in the same directory as Mallard pages, but those are minor issues in my opinion. Looks like nobody has tried linking PNGs from within SVG files yet? :P I started Inkscape, took a PNG screenshot (nothing to translate) and linked (not: embedded) it from within an SVG file. The PNG is the lowest layer in the SVG and I could put text in the layer above which could theoretically be parsed and translated. I didn't want to embed the PNG in SVG - per Fred's explanations above I'd waste bytes by duplicating the PNG data for each translation. Now Yelp 3.10 displays the SVG, but not the external PNG below. I filed https://bugzilla.gnome.org/show_bug.cgi?id=723983 with a testcase. andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
How to test code examples in platform-demos?
https://git.gnome.org/browse/gnome-devel-docs/tree/platform-demos/C seems to have inline code examples, like code mime=application/javascript style=numbered ![CDATA[ foo(bar); ]] /code pSome explanation of the next line:/p code mime=test/x-python style=numbered ![CDATA[ bar(foo); ]] /code Does any approach exist to make sure these code examples do not include deprecated code, do not include superceded approaches, do not trigger warnings, do actually compile? If I wanted to test them, what would I be expected to do? Parse the content of all code nodes, concatenate that in a file, then try to compile and/or execute it? Or are our numerous code examples inside one Mallard page not self-contained? (Background: At FOSDEM there was a talk called Unicorns about testing documentation, and apart from the usual Cucumber/Selenium praise of our current times that GNOME is far away from, one recommendation was to automatically compile code examples with warnings and deprecations enabled and making them a compile failure as a mandatory part of integration testing. I don't see us doing integration testing soon, but it would already be a great step to be able to manually compile them.) andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
SVGs! Languages! ♥!
Hola, I updated two screenshots in the gnome-user-docs/gnome-help and wanted to update even more. But! Looking at https://git.gnome.org/browse/gnome-user-docs/plain/gnome-help/C/figures/top-bar-icons-classic.png?h=master https://git.gnome.org/browse/gnome-user-docs/plain/gnome-help/C/figures/top-bar-icons.png?h=master they include text. So nobody ever translates them. Ever. I was about to replace the text in the PNG by numbers and explain the meaning of those numbers in text so translators could translate. But then Kat appeared and said that SVG is the future! And SVGs allows embedding multiple languages (via ‘systemLanguage’ and ‘switch’): http://www.w3.org/TR/SVG/struct.html#SystemLanguageAttribute I decided that Shaun should fix this (or at least pretend to do so) and talk to Kat on how to do this properly. I called it delegation. andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ attachment: top-bar-icons.pngattachment: top-bar-icons-classic.png___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: Doc team related stuff in Bugzilla
Meooow (with a slight rooar in there), On Sat, 2014-01-25 at 16:06 +0530, Sindhu S wrote: Quack! If we tried to make a Bugzilla query for documentation components easier (ignoring the documentation keyword), a first step might be to reduce the number of different names for the same component. Below is a quick and dirty list. - need to remove those projects where GNOME documentation team does not maintain the documentation instead of the project developers (sounds like a candidate for quick Etherpad editing at Hackfest) I did a similar one for projects.gnome.org to round up those git repositories which haven't seen a commit in 2 years/generally not being actively maintained. [1]. Meh. And now http://projects.gnome.org/ redirects to https://wiki.gnome.org/Apps ... One year ago one third of the projects in GNOME Git had not seen any code activity for the last two years. If a project does not use yelp-tools and is not a GNOME 3 app yet then what is the resolution? Resolution to which problem? :) I'm not sure if we talk about the same thing - Personally I don't have problems with non-GNOME3 apps and their documentation so far. :P Should we consult the maintainers to see if they are going to port to GNOME3 and thus are willing to use yelp-tools? For example: https://bugzilla.gnome.org/show_bug.cgi?id=698497 Ah, development related. Alright, I'm out, I'm a user docs and Bugzilla guy. :) - need to remove projects which are dead / unmaintained because we don't care (I might have a script somewhere left for that I think) Wouldn't this make bugzilla out of sync with projects.gnome.org or even git.gnome.org? Say if the project doesn't exist on bugzilla.gnome.org but its source is available on git.gnome.org. Remove from the list that I pasted below in my email that the documentation team could use as a base. I did not mean to remove any projects from Bugzilla. I am sorry for any confusion. +1 and auto create these for new projects on bugzilla on behalf of maintainers/ developers? Automatically creating won't be easy, but it could be added to the guidelines for Bugzilla admins at https://wiki.gnome.org/BugzillaMaintainers/CreatingNewProducts (after finding some agreement on what to actually propose here). Cheers, andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: Doc team related stuff in Bugzilla
On Thu, 2014-01-23 at 16:44 +, Ekaterina Gerasimova wrote: On 23 January 2014 16:35, Andre Klapper ak...@gmx.net wrote: Yo. It's hackfest time so I tried to come up with half-useful Bugzilla queries (though six different component names, Bugzilla's technical inabilities, our 63 ways to tag something as docs related, plus devel vs. user docs don't make it easy). I think working on reducing that number would be a good goal for the hackfest. I have found that our oodles of different ways to mark docs bugs as docs is quite confusing for newcomers. Sindhu did a good job of triaging some of the bugs last year, but I think we should make a push to keep them a bit more under control in general. If we tried to make a Bugzilla query for documentation components easier (ignoring the documentation keyword), a first step might be to reduce the number of different names for the same component. Below is a quick and dirty list. - need to remove those projects where GNOME documentation team does not maintain the documentation instead of the project developers (sounds like a candidate for quick Etherpad editing at Hackfest) - need to remove projects which are dead / unmaintained because we don't care (I might have a script somewhere left for that I think) - need guidelines for project maintainers on component naming (though they might be ignored of course) as maintainers can create components themselves in our Bugzilla setup - wondering whether something like Dev Docs vs User Docs might make sense (but that would mean a large renaming, plus people might search for the term Doc... in the component list?) Comments? I think I'll grab some plane now. doc (3): * dia * libpeas * nanny docs (57): * aisleriot * at-spi * atk * banshee * baobab * beast * bug-buddy * encompass * file-roller * GConf * gconf-editor * gdm * gedit * gftp * glib * gnome-applets * gnome-calculator * gnome-desktop * gnome-doc-utils * gnome-games * gnome-mud * gnome-netstatus * gnome-nettool * gnome-panel * gnome-pm * gnome-print * gnome-terminal * gnome-utils * gnome-vfs-extras * gnomeradio * Gnomoradio * gnopernicus * gnorpm * gok * goobox * gparted * gpdf * gtetrinet * gtkglarea * gtkglext * gtkglext * gtop * gucharmap * guile-gnome * libunique * libwnck * libxml2 * pango * pessulus * pygoocanvas * seahorse * sound-juicer * system-monitor * ToutDoux * xchat-gnome * xmlsec * zenity Docs (2): * billreminder * gnome-vfs documentation (37): * accerciser * anjuta * bluefish * doxygen * eog * folks * geary * gexiv2 * glade * glibmm * gnome-boxes * gnome-commander * gnome-documents * gnome-klotski * gnome-mag * gnome-mahjongg * gnome-mines * gnome-robots * gnome-tetravex * gnote * goocanvas * GStreamer * gtkmm * gtranslator * libchamplain * libgnomecanvas * libgnomedb * libsigc++ * lsr * orbit-cpp * pangomm * pygobject * pygtk * shotwell * Silky * swell-foop * totem Documentation (35): * bakery * bijiben * bounties * clutter * cogl * conglomerate * deskbar-applet * ekiga * epiphany * fast-user-switch-applet * galeon * giggle * gnome-chess * gnome-db * gnome-directory-thumbnailer * gnome-video-arcade * GnuCash * Gnumeric * gossip * gtk+ * hitori * lampadas * libgda * libgsf * libxml++ * medusa * mergeant * nautilus * NetworkManager * pitivi * planner * rhythmbox * Tomboy * vala * vinagre documentation and translation (1): * conduit help (1): * cheese Help (1): * GIMP User documentation (1): * evince User Documentation (1): * Evolution User Guide (1): * empathy user-faq (1), user-guide (1): * gnome-user-docs andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: gnome-control-center: UI Freeze Break (707285)
On Tue, 2013-09-03 at 10:01 +, Debarshi Ray wrote: The patch in https://bugzilla.gnome.org/show_bug.cgi?id=707285 increases the height of the Add Accounts dialog a bit to accommodate the new chat providers. Patch and screenshots are attached to the bug report. Looks fine to me. r-t approval 1 of 2. andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ signature.asc Description: This is a digitally signed message part ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: How about fcitx for Chinese Input(EOM)
Hi, On Sat, 2013-05-25 at 13:31 +0800, 大米 wrote: Thanks for your email. Please elaborate what exactly you refer to, what you mean by How about, maybe provide some links to fcitx, and why you sent this to the mailing list for GNOME documentation. Thanks, andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Patches to review in Bugzilla
Don't know where to put this on https://live.gnome.org/DocumentationProject/ , but as I just closed https://bugzilla.gnome.org/show_bug.cgi?id=655209 as WONTFIX, the query to find patches in Bugzilla without review for bugs assigned to the GNOME User docs maintainers: https://bugzilla.gnome.org/buglist.cgi?field0-0-0=attachments.status;emailtype1=exact;query_format=advanced;emailassigned_to1=1;bug_status=UNCONFIRMED;bug_status=NEW;bug_status=ASSIGNED;bug_status=REOPENED;bug_status=NEEDINFO;email1=gnome-user-docs-maint%40gnome.bugs;type0-0-0=equals;value0-0-0=none andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: Getting started for Gnome outreach
Hi Sowmya, thanks for your interest! On Sun, 2013-04-14 at 22:09 +0530, Sowmya Ravidas wrote: I have found a bug - https://bugzilla.gnome.org/show_bug.cgi?id=695952 and I am interested in working on it. Could someone please guide me on how to get started and fix the bug? This should be covered by https://live.gnome.org/DocumentationProject/Contributing In short: check out the gnome-user-docs module from GNOME's Git code repository, test the current behavior in GNOME 3.8/3.9, change/update the documentation file accordingly, create a git-formatted patch that includes your changes, and attach the patch file to the corresponding Bugzilla report. Also, where can I find the project ideas for gnome-documentation Have you explored https://live.gnome.org/DocumentationProject a bit? Cheers, andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: shell freeze break request
On Mon, 2013-03-18 at 09:47 -0400, Ray Strode wrote: Allan did some theming patches to make the session list a little less out of place looking. It would be good if we could get this into 3.8 as an interim solution until we get a new session list design / implementation. The before is here: http://people.gnome.org/~halfline/old-session-list.png and the after is here: http://people.gnome.org/~halfline/new-session-list.png Looks good, but where are the patches to review? andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: gnome-terminal bug #695757
CC'ing gnome-doc-list to check if terminal user docs are affected. On Fri, 2013-03-15 at 18:44 +0100, Christian Persch wrote: Am Fri, 15 Mar 2013 18:36:25 +0100 schrieb Olav Vitters o...@vitters.nl: On Fri, Mar 15, 2013 at 06:05:00PM +0100, Christian Persch wrote: during 3.7 the New terminal menu entries were removed from gnome-terminal's context menu. However, planned work that would have added a way to create a new terminal to the app menu hasn't happened yet. Since it's the minimal-impact fix for 3.8, I'd like to just revert the commit [2]. It's a small UI change, so I ask for approval here. approval 1/2 I assume no l10n impact... Right, all strings still existed (the commit only removed the menu entries, not the GtkAction or the code backing it). Might have docs impact; not sure if the context menu is documented. r-t approval 2 of 2. andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: GNOME Control Center: UI freeze break request
On Mon, 2013-03-04 at 19:18 -0500, Michael Hill wrote: On Mon, Mar 4, 2013 at 6:19 PM, Matthias Clasen matthias.cla...@gmail.com wrote: On Mon, Mar 4, 2013 at 10:49 AM, Debarshi Ray rishi...@lostca.se wrote: I would like to commit this patch to the Online Accounts panel in GNOME Control Center for 3.7.91: https://bugzilla.gnome.org/show_bug.cgi?id=688056 Screenshots are available on the bug. The following new strings were added: Mail Contacts Resources Other I have been using this patch locally on my system for quite some time and it is reasonably low impact. +1 from me for the release team. +1 from docs team. r-t approval 2 of 2. andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: Boxes UI freeze break request
Hi Mike, On Tue, 2013-03-05 at 08:46 -0500, Michael Hill wrote: I'm requesting a freeze break for the Help app menu item for Boxes[1]. [1] https://bugzilla.gnome.org/show_bug.cgi?id=695212 That report is not clear to me at all. Does Help in the app menu already exist and just needs to be linked against help:gnome-boxes ? If so, no new string would be introduced, and no UI change takes place either. Plus (wearing the r-t hat) I cannot review anything without a patch. Bonuspoints for screenshots so the docs team knows what to do (though you're part of the docs team anyway). andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list
Re: Boxes UI freeze break request
On Tue, 2013-03-05 at 10:13 -0500, Michael Hill wrote: On Tue, Mar 5, 2013 at 8:59 AM, Michael Hill mdhil...@gmail.com wrote: Sorry, help was just merged and the app menu needs a 'Help' entry to access it. Patch is pending. Patch submitted and reviewed. So we talk about one string addition, Help, which after the string freeze would require OKs from L10N/I18N. r-t approval 1 of 2 for the patch. andre -- Andre Klapper | ak...@gmx.net http://blogs.gnome.org/aklapper/ ___ gnome-doc-list mailing list gnome-doc-list@gnome.org https://mail.gnome.org/mailman/listinfo/gnome-doc-list