Re: Tipping the apple cart?
Please lets keep in mind that this is not a thread to complain about Gitlab. No platform is perfect, and we're not yet on production machines. This thread is about how to make our review process great for both newbies and experienced developers, *and reviewers* - on Gitlab. On Sun, Jun 30, 2019 at 2:53 PM Valorie Zimmerman < valorie.zimmer...@gmail.com> wrote: > Hello folks, as you know, I'm not a coder. However, I'm interested in our > code quality, and there has been some observation that "lots of patches get > missed, and submitters get confused due to a lack of auto-populated > reviewers" on Phabricator. Nate Graham has been adding groups to the > reviewers by hand, and would like to not do that any more. > > However, many developers simply route all Phab emails to folders where > they sit unread, because Phab sends out an email for every event and > comment! This is far too spammy. In our move to Gitlab, we can do better. > Right now, the devel email lists get these emails -- but it is assumed that > they are often not read, because of the number of patches sitting > unreviewed, and unused. This is bad for our community, and very > discouraging to newcomers. One of our best recent initiatives has been the > improve our onboarding process, and this needs to be part of it. > > Improving the workflow on Phabricator is almost pointless, since we're > leaving it. However, please give your ideas, thoughts and even opinions on > how best to improve this in Gitlab. I think if we engineer this well, we > can get more newbie contributors and more new *reviewers.* > > I'm ok with starting Yet Another discussion which threatens to tip the > apple cart, because right now, the apples are already on the ground, > rotting. > > Valorie >
Tipping the apple cart?
Hello folks, as you know, I'm not a coder. However, I'm interested in our code quality, and there has been some observation that "lots of patches get missed, and submitters get confused due to a lack of auto-populated reviewers" on Phabricator. Nate Graham has been adding groups to the reviewers by hand, and would like to not do that any more. However, many developers simply route all Phab emails to folders where they sit unread, because Phab sends out an email for every event and comment! This is far too spammy. In our move to Gitlab, we can do better. Right now, the devel email lists get these emails -- but it is assumed that they are often not read, because of the number of patches sitting unreviewed, and unused. This is bad for our community, and very discouraging to newcomers. One of our best recent initiatives has been the improve our onboarding process, and this needs to be part of it. Improving the workflow on Phabricator is almost pointless, since we're leaving it. However, please give your ideas, thoughts and even opinions on how best to improve this in Gitlab. I think if we engineer this well, we can get more newbie contributors and more new *reviewers.* I'm ok with starting Yet Another discussion which threatens to tip the apple cart, because right now, the apples are already on the ground, rotting. Valorie -- http://about.me/valoriez - pronouns: she/her
Google Summer of Code Ideas
Hi folks, a few teams have added their ideas to https://community.kde.org/GSoC/2019/Ideas but many have not yet done so. Those of you reading this plea have participated in the past but do not have ideas posted yet. PLEASE get this done before the end of the year! We need to submit our application 15 January 2019 which is about one month away. So I beg of you, please get your ideas up soon. Valorie -- http://about.me/valoriez
D16588: Change package manager icons to emblems
valorie added a comment. Could not Muon be updated in this way as well? It now uses a package icon for all packages which seems a waste of space. REPOSITORY R266 Breeze Icons BRANCH package-manager-icons (branched from master) REVISION DETAIL https://phabricator.kde.org/D16588 To: ndavis, #vdg, ngraham Cc: valorie, bruns, ngraham, #vdg, kde-frameworks-devel, michaelh
D16395: Update the "About KDE" text
valorie added a comment. My only suggestion: KDE creates the efficient, powerful Plasma desktop environment, hundreds of high-quality applications and the many software libraries that support them. Past tense makes the present version seem static. REPOSITORY R263 KXmlGui REVISION DETAIL https://phabricator.kde.org/D16395 To: ngraham, #vdg, #plasma, #frameworks, #kde_applications, #kde_promo Cc: valorie, davidc, xyquadrat, rizzitello, ltoscano, aspotashev, abetts, kde-frameworks-devel, michaelh, ngraham, bruns
Re: Frameworks release schedule?
On Wed, Oct 25, 2017 at 1:44 AM, Harald Sitter <sit...@kde.org> wrote: > On Wed, Oct 25, 2017 at 10:35 AM, laurent Montel <mon...@kde.org> wrote: >> Hi, >> I send this email to kde-frameworks-devel >> >> It's the correct ML for having an answer about it >> >> Regards. Hi Laurent, I thought that frameworks-devel was being deprecated but I guess I'm out of the loop. So thanks. >> Le mercredi 25 octobre 2017, 09:29:58 CEST Valorie Zimmerman a écrit : >>> Hello folks, with my Kubuntu release manager hat on, I was filling in >>> the calendar for the next 6 months. For Frameworks, this page: >>> https://community.kde.org/Schedules/Frameworks is now on a provisional >>> schedule - 5.40 (expected) Sat November 4th, 2017 for tagging, >>> (expected) Sat November 11th, 2017. >>> >>> Is the schedule for the next 6 months still undecided, or has the wiki >>> page just not been filled in yet? > > "... and so on. Until further notice: tagging happens the first > saturday of every month, and the public release is one week later." > > That generally holds true unless something causes or needs an > extraordinary delay (which in the past has never been more than a > couple of days). > > HS Thanks Harald! Valorie -- http://about.me/valoriez
NOW is the time to fill in the Ideas page for GSoC! Application deadline 9 Feb.
Hello GSoC mentors, and teams supporting mentors, We've asked for more time to get ramped up for GSoC, and so the calendar has been moved back to early February. However, that means that our Ideas page needs to be filled NOW, so that it can be taken into consideration once the Org Applications are all in. The quality of our ideas and the guidance they give our students are the most important part of our application. Please begin filling in your ideas now, and ensure that it is comprehensive and accurate. Including screenshots and other images is allowed, if it enriches the idea for a project. Please ensure complete information about how to contact the team; this is crucial. Take a look at the landing page https://community.kde.org/GSoC -- experienced mentors agree that 1. commits must be made before the student proposal is submitted, and linked on that proposal, and 2. that regular communication from the student must be initiated by the student at least weekly, and we expect daily or nearly daily communication with the team in a more informal way. Be sure to point students to that information, as this should thin our proposals, and raise the quality. TL;DR: Fill out https://community.kde.org/GSoC/2017/Ideas; read https://community.kde.org/GSoC. Now. Valorie -- http://about.me/valoriez
Season of KDE -- please add your ideas
Hello developers, Do you have a project in mind which will help KDE? Season of KDE might be for you. KDE Student Programs has announced the 2016-2017 Season of KDE for those who want to participate in mentored projects which enhance KDE in some way. Projects from past Seasons of KDE include new application features, the KDE Continuous Integration system, new reporting for developers, a web framework, porting and a lot of other work. Successful mentees earn a certificate of completion along with a very cool tee shirt and other goodies. Any person who wants to complete a project is eligible to enter. Those who want to mentor are asked to add ideas here: https://community.kde.org/SoK/Ideas/2016. The sooner the better, please! *This means you!* Students are asked to begin discussion about your ideas or those on the various KDE mail lists and IRC channels even before applications open. The more consultation is done with the team you want to work with, the more likely you are to succeed. The schedule this year will be: * 7 October to 31 October: Student and mentor applications * 1 November: Official coding period begins. Students can start work after once mentor and student agree on the project scope and the timeline * 28 February : End of coding period To apply as a mentor or student, please visit https://season.kde.org Valorie, on behalf of the Student Programs team
Re: Review Request 126078: [OS X] modernising the KIdleTime plugin (WIP!)
--- This is an automatically generated e-mail. To reply, visit: https://git.reviewboard.kde.org/r/126078/#review88573 --- Hello folks, Martin Graesslin has asked the CWG to step in here. This is Valorie writing. I can't comment on the technical aspects here, but I'm disappointed in the way this was handled. The review process is really important to the entire KDE community. We share our proposals, ask for feedback, then engage in dialog. This is *thinking together.* Instead, I'm seeing defensiveness, exasperation, and finally anger. Please, everyone step back, calm down, and let's reconsider the issue afresh. Surely we can do a better job in providing great software to our users. - Valorie Zimmerman On Nov. 18, 2015, 4:35 p.m., René J.V. Bertin wrote: > > --- > This is an automatically generated e-mail. To reply, visit: > https://git.reviewboard.kde.org/r/126078/ > --- > > (Updated Nov. 18, 2015, 4:35 p.m.) > > > Review request for KDE Software on Mac OS X, KDE Frameworks and Dario Freddi. > > > Repository: kidletime > > > Description > --- > > I noticed that the KIdleTime example doesn't work properly on OS X, and that > the plugin for OS X still uses the deprecated Carbon-based algorithm that I > already patched for KDE4. > > This patch is a work-in-progress (hence the qDebugs) update to use IOKit, > IORegistry and CoreServices to do idle-time calculation as it should be done, > and allow simulated user activity through a "less deprecated" function. > > > Diffs > - > > src/plugins/osx/CMakeLists.txt e1b50b8 > > Diff: https://git.reviewboard.kde.org/r/126078/diff/ > > > Testing > --- > > On OS X 10.9 with Qt 5.5.1 and frameworks 5.16.0 . > > The example now works: when I set a QTimer with interval==0, the expected > wait for user input (`resumingFromIdle` signal) works. However, I am getting > a `stopCatchingIdleEvents` signal which means the application waits forever, > without ever getting to compare idle time to the list of timeouts. > I haven't been able to figure out where that signal comes from, nor why this > doesn't happen on Linux. > > Surely I'm missing something, but what? > > > Thanks, > > René J.V. Bertin > > ___ Kde-frameworks-devel mailing list Kde-frameworks-devel@kde.org https://mail.kde.org/mailman/listinfo/kde-frameworks-devel
Fwd: Books BoF
Hello folks, Our Frameworks Cookbook is good, but incomplete. Let's figure out how to improve what we have, and complete what we don't. We can meet later in the week to hack if necessary. I've scheduled a BoF at 17:00 Monday, following the Future Frameworks Releases BoF that Ervin is hosting, in the same room, Lab 0.5w, Monday, 27 July. Please put that on your calendar if you are interested! #kde-books in IRC, books.kde.org on the web. All the best, Valorie -- http://about.me/valoriez ___ Kde-frameworks-devel mailing list Kde-frameworks-devel@kde.org https://mail.kde.org/mailman/listinfo/kde-frameworks-devel
Re: Books BoF
On Thu, Jul 23, 2015 at 2:27 AM, Valorie Zimmerman valorie.zimmer...@gmail.com wrote: Hello folks, Our Frameworks Cookbook is good, but incomplete. Let's figure out how to improve what we have, and complete what we don't. We can meet later in the week to hack if necessary. I've scheduled a BoF at 17:00 Monday, following the Future Frameworks Releases BoF that Ervin is hosting, in the same room, Lab 0.5w, Monday, 27 July. Please put that on your calendar if you are interested! #kde-books in IRC, books.kde.org on the web. All the best, Valorie PS: Proposed topics: https://community.kde.org/Akademy/2015/Monday/Books ___ Kde-frameworks-devel mailing list Kde-frameworks-devel@kde.org https://mail.kde.org/mailman/listinfo/kde-frameworks-devel
Re: Qt DevDays is coming; do we want to print up some Frameworks Cookbooks to give to attendees?
On Thu, Oct 2, 2014 at 9:28 AM, Jeremy Whiting jpwhit...@kde.org wrote: Valorie, I'm a bit confused. books.kde.org says the book is hosted at flossmanuals, but that url takes me to the oldish KDE Dev Guide is thi Frameworks Cookbook a different thing than that old book, right? Is the current wip book available somewhere ? I guess if so we should point that link at it (and also turn the epub, pdf etc. text below the cover there into links) If not what's needed to make it from the git repo? I saw one or so tasks on the kanboard about generating a book, is that to generate the epub/pdf/html from the git repo? or to print the actual hard copy once we have the epub/pdf/html ? thanks, Jeremy On Wed, Oct 1, 2014 at 11:43 PM, Valorie Zimmerman valorie.zimmer...@gmail.com wrote: https://www.qtdeveloperdays.com/europe says that Qt DevDays happens October 6 – 8, at the Berlin Congress Centre in Berlin. If we want to print up some books to give away, we need some more chapters. See https://books.kde.org for more details. Valorie Yes, the older book is at the top. We eventually would like to get that book into git as well, so that all devels can easily fix as needed. Scroll down for the new book, the Frameworks Cookbook. Valorie ___ Kde-frameworks-devel mailing list Kde-frameworks-devel@kde.org https://mail.kde.org/mailman/listinfo/kde-frameworks-devel
Re: Qt DevDays is coming; do we want to print up some Frameworks Cookbooks to give to attendees?
Hi Brian, we did generate a PDF epub of an early version, but if you want to see the chapters now, you'll need to clone the git repo and read it from there. If there is enough interest, I'm sure Mirko would generate the PDF ePub files right now, although I think the README tells you how to do this for yourself. There is not enough to publish until we get some more content. I get that everyone is coding like mad right now, but we are swiftly running out of time to print before Qt DevDays. Valorie On Fri, Oct 3, 2014 at 6:14 AM, Brian Duffy brdu...@gmail.com wrote: Why does that url not provide a copy of the book? Is it not ready for viewing at all? On Thu, Oct 2, 2014 at 12:28 PM, Jeremy Whiting jpwhit...@kde.org wrote: Valorie, I'm a bit confused. books.kde.org says the book is hosted at flossmanuals, but that url takes me to the oldish KDE Dev Guide is thi Frameworks Cookbook a different thing than that old book, right? Is the current wip book available somewhere ? I guess if so we should point that link at it (and also turn the epub, pdf etc. text below the cover there into links) If not what's needed to make it from the git repo? I saw one or so tasks on the kanboard about generating a book, is that to generate the epub/pdf/html from the git repo? or to print the actual hard copy once we have the epub/pdf/html ? thanks, Jeremy On Wed, Oct 1, 2014 at 11:43 PM, Valorie Zimmerman valorie.zimmer...@gmail.com wrote: https://www.qtdeveloperdays.com/europe says that Qt DevDays happens October 6 – 8, at the Berlin Congress Centre in Berlin. If we want to print up some books to give away, we need some more chapters. See https://books.kde.org for more details. Valorie ___ Kde-frameworks-devel mailing list Kde-frameworks-devel@kde.org https://mail.kde.org/mailman/listinfo/kde-frameworks-devel
Fwd: Qt DevDays is coming; do we want to print up some Frameworks Cookbooks to give to attendees?
https://www.qtdeveloperdays.com/europe says that Qt DevDays happens October 6 – 8, at the Berlin Congress Centre in Berlin. If we want to print up some books to give away, we need some more chapters. See https://books.kde.org for more details. Valorie -- http://about.me/valoriez ___ Kde-frameworks-devel mailing list Kde-frameworks-devel@kde.org https://mail.kde.org/mailman/listinfo/kde-frameworks-devel
Attention KDE Frameworks 5 Cookbook authors
Hi folks, if you intend to get a chapter or section into the first edition of the cookbook, please commit as soon as possible. We need to get this all put together and out to a printer in time to have copies in hand at Akademy. I hope we'll have a copy for each contributor. If you were not at Randa, you can still contribute! And we need good reviewers as well as writers. In fact, if you don't think you can write, but there is already good material (blogs, techbase, etc.) about the framework(s) you know well, please collect that material and submit it. We'll make it fit together coherently. Just be sure that what you submit is technically accurate; we'll make it readable. For those of you have not yet seen https://books.kde.org - this is a living project. Our end goal is to cover all the frameworks, enlarging the prospective audience from Qt-only developers, to include KDE developers too, who want to incorporate the frameworks into their code. All the best, Valorie, for the KDE Books team -- http://about.me/valoriez ___ Kde-frameworks-devel mailing list Kde-frameworks-devel@kde.org https://mail.kde.org/mailman/listinfo/kde-frameworks-devel
Re: Attention KDE Frameworks 5 Cookbook authors
On Tue, Aug 26, 2014 at 12:00 AM, Marko Käning mk-li...@email.de wrote: Hi Valorie, is there already a PDF somewhere accessible, or does one need to build it locally still? Greets, Marko Hi Marko, Please read Mirko's recent blog: http://creative-destruction.me/2014/08/25/how-to-contribute-to-the-kde-frameworks-cookbook/ When we release we'll have a PDF ePub available, as well as Techbase pages. Until then, it must be built locally. Valorie -- http://about.me/valoriez ___ Kde-frameworks-devel mailing list Kde-frameworks-devel@kde.org https://mail.kde.org/mailman/listinfo/kde-frameworks-devel
Re: [kde-promo] need flyer content and design for Qt DevDays
On Sun, Aug 24, 2014 at 6:10 AM, Lydia Pintscher ly...@kde.org wrote: Hey folks :) Qt DevDays is coming up and we have the opportunity to add a flyer to the welcome bag. I think we should do this. It should be a flyer about Frameworks 5. Ideally we can re-use the same flyer later for other events like FOSDEM. It should be no bigger than A4 but imho half that size would be ideal. We need this in the next 2 weeks so we can get it printed and shipped in time. Is anyone willing to make this happen? It'd be a shame to not use this opportunity to reach so many Qt developers. Cheers Lydia (Let's keep the discussion on the promo list. CC'd frameworks list in hope someone there can help with content.) -- Lydia Pintscher - http://about.me/lydia.pintscher Perhaps part of the text could be a link to our KF5 book, since we did write it for Qt devels. https://books.kde.org Valorie ___ Kde-frameworks-devel mailing list Kde-frameworks-devel@kde.org https://mail.kde.org/mailman/listinfo/kde-frameworks-devel
I think you should join 101 Pines/Horseshoe Lake's private website
Hello, Valorie Zimmerman invites you to join your 101 Pines/Horseshoe Lake neighbors on Nextdoor. Nextdoor is a free and private social network that your neighbors are using. Valorie wrote: Our neighborhood is using a private online network called Nextdoor 101 Pines/Horseshoe Lake. On our Nextdoor site, neighbors share community events, recommendations, items for sale/free, crime/safety concerns, ideas about how to make our neighborhood better, and more. I think you'd also benefit from joining Nextdoor. Please join us to build better neighborhoods! Accept Valorie's invitation: https://nextdoor.com/choose_address/?i=hkczsxstage=0te=1 It's free and only takes a minute. WHAT IS NEXTDOOR? Nextdoor is a free, private social network for your neighborhood. * Build a stronger neighborhood Connect with your neighbors to stay informed and share useful local information. * Keep the neighborhood safe Look out for each other and send updates to keep the neighborhood safe. * Share goods and recommendations Find a great babysitter or trusty dentist. Borrow a ladder or sell that old bookcase. See your neighborhood in action: https://nextdoor.com/choose_address/?i=hkczsxstage=0te=1 To stop receiving email reminders about this invitation, please follow the unsubscribe link below: https://101pineshorseshoelake.nextdoor.com/inv_unsub/?e=kde-frameworks-devel%40kde.orgk=6092244d28ea565 This message was sent by Nextdoor, 760 Market Street, Suite 300, San Francisco, CA 94102, and intended for kde-frameworks-devel@kde.org.___ Kde-frameworks-devel mailing list Kde-frameworks-devel@kde.org https://mail.kde.org/mailman/listinfo/kde-frameworks-devel
Books.kde.org!
Greetings again from Randa. https://books.kde.org is now live. It redirects to a Techbase page, where we'll keep all the relevant information and links. Most important: proper repo, at kde:kf5book . Our ToDos are here: https://todo.kde.org/?controller=boardaction=showproject_id=15 . If you can't or do not want to write, feel free to review chapters, tooling, processes, images, etc. and help us out that way. Thanks so much for the folks who have pitched in already! We'd like to release this book before Akademy, so that there are not online online/pdf/ePub versions available, but also some printed books. Hang out with us in #kde-books Best, Valorie -- http://about.me/valoriez ___ Kde-frameworks-devel mailing list Kde-frameworks-devel@kde.org https://mail.kde.org/mailman/listinfo/kde-frameworks-devel
Kitemviews
Martin Klapetek suggested that Kitemviews would be a useful framework to include in our book. However, I can find no documentation *anywhere.* I found this on a Mandriva page: The ItemViews framework contains data views on top of QAbstractItemView that help in common tasks, such as sorting, proxying and filtering. ItemViews contains useful classes such as a view for checkable or selectable items, recursive filtering and breadcrumb selection. That sounds useful! Does someone want to write a nice markdown description etc. about it? And then commit push to kde:scratch/garg/book Thanks, Valorie -- http://about.me/valoriez ___ Kde-frameworks-devel mailing list Kde-frameworks-devel@kde.org https://mail.kde.org/mailman/listinfo/kde-frameworks-devel
Re: Kitemviews
On Tue, Aug 12, 2014 at 9:03 AM, Sebastian Kügler se...@kde.org wrote: On Tuesday, August 12, 2014 17:42:24 Albert Astals Cid wrote: El Dimarts, 12 d'agost de 2014, a les 08:18:40, Valorie Zimmerman va escriure: Martin Klapetek suggested that Kitemviews would be a useful framework to include in our book. However, I can find no documentation *anywhere.* I found this on a Mandriva page: The ItemViews framework contains data views on top of QAbstractItemView that help in common tasks, such as sorting, proxying and filtering. ItemViews contains useful classes such as a view for checkable or selectable items, recursive filtering and breadcrumb selection. This sounds good, can't we just ask the Mandriva people if we can copy it? I wrote it as part of the Frameworks descriptions. I went over all the frameworks a while back to describe what they do. I can't find it back on the web, however, I had put it in a wiki page back, then, but it's probably moved from there elsewhere. I'm not sure that that's good enough for copyright tracking. Cheers, -- sebas More to the point, a brief sentence isn't enough. We need a chapter, or at least a longish section if we're to be useful to Qt developers who don't know about the framework at all. Valorie ___ Kde-frameworks-devel mailing list Kde-frameworks-devel@kde.org https://mail.kde.org/mailman/listinfo/kde-frameworks-devel
Re: For Book Sprint team: Frameworks Cookbook
New URL: http://booktype-demo.sourcefabric.org/kde-frameworks-5/ You should be able to use your same login as for Booki. Please just start a new chapter if you don't know where to add your code snippet, explication or just anecdotes. Don't worry about anything else, just write something! Valorie On Wed, Aug 6, 2014 at 3:22 AM, Valorie Zimmerman valorie.zimmer...@gmail.com wrote: Hi folks, I've started a book for you to play with. Load up http://booki.flossmanuals.net/kde-frameworks-cookbook/_edit/ and have fun. Make a login, make some chapters, drag them around, and see what everything looks like. ::snip old:: ___ Kde-frameworks-devel mailing list Kde-frameworks-devel@kde.org https://mail.kde.org/mailman/listinfo/kde-frameworks-devel
For Book Sprint team: Sample Frameworks Cookbook
Hi folks, I've started a book for you to play with. Load up http://booki.flossmanuals.net/kde-frameworks-cookbook/_edit/ and have fun. Make a login, make some chapters, drag them around, and see what everything looks like. Unfortunately the editor won't save for me tonight; I actually did add content to a chapter, but I can't see it. I'll consult the flossmanuals folks about this or try different browsers tomorrow. See you soon in Randa! Valorie -- http://about.me/valoriez ___ Kde-frameworks-devel mailing list Kde-frameworks-devel@kde.org https://mail.kde.org/mailman/listinfo/kde-frameworks-devel
Frameworks Cookbook book sprint
Our time together is coming close! It would be good to decide on what writing platform we'll use. Rohan and I are both familiar with Booki at Flossmanuals. I found a book (available as an epub too) about Booki itself: http://www.flossmanuals.net/booki-user-guide/ Flossmanuals also has a nice guide to running book sprints: http://flossmanuals.net/book-sprints/ It has also been suggested that we use Sourcefabric: http://www.sourcefabric.org/en/booktype/ There was a meet where both these platforms were discussed: http://www.flossmanuals.org/news/booktype-floss-manuals-ebooks-learning-platform-future-cetis-2014 Perhaps we should test these out a bit, and see which suits the majority of us -- including you remote writers. Valorie -- http://about.me/valoriez ___ Kde-frameworks-devel mailing list Kde-frameworks-devel@kde.org https://mail.kde.org/mailman/listinfo/kde-frameworks-devel
Please blog about Randa Meetings
Hi folks, You all know about the upcoming Randa spints, and the book we'll be writing. Whether or not you are coming, Frameworks as a whole will benefit from the spints. Please support the meeting with your money, in your blogs, and on your social media. We'd love to have hundreds of small contributions rather than a few large ones. There have been few blogs on Planet KDE so far; it's rather disappointing. The fundraising is not coming along very fast yet either. We can turn this around. Please blog, please tweet, please post on G+ and/or Facebook. Spread it around on non-KDE communication channels too: this promotes KDE and free software as a whole. Always include the fundraising link! [1] Thanks for your work, and see you soon in Randa, Valorie 1. http://www.kde.org/fundraisers/randameetings2014/ -- http://about.me/valoriez ___ Kde-frameworks-devel mailing list Kde-frameworks-devel@kde.org https://mail.kde.org/mailman/listinfo/kde-frameworks-devel
Re: Writing a Frameworks book at Randa
On Sun, May 4, 2014 at 1:33 AM, Martin Graesslin mgraess...@kde.org wrote: On Saturday 03 May 2014 23:56:53 Valorie Zimmerman wrote: I know I said On Sat, May 3, 2014 at 2:14 AM, Valorie Zimmerman valorie.zimmer...@gmail.com wrote: Time is short, so this is the last time I'll write. Think about what you want in your Frameworks book and commit to making it happen. Valorie 1. https://sprints.kde.org/sprint/212 but I think we have enough people signed up to to make this happen! Thanks to all of you who have stepped forward. it would be great if you could make remote participation possible. While it's too difficult for me to participate in the sprint directly I would be able to remote participate. Cheers Martin Excellent idea, Martin. I'll try to have instructions for those who want to participate remotely all set up before we arrive in Randa. For now, I hope people will start filling in the wiki page, and get ideas percolating. Of course we will have IRC, but I hope it will be easy for people to directly work on the book text from everywhere. Valorie -- http://about.me/valoriez ___ Kde-frameworks-devel mailing list Kde-frameworks-devel@kde.org https://mail.kde.org/mailman/listinfo/kde-frameworks-devel
Re: Re: Writing a Frameworks book at Randa
I know I said On Sat, May 3, 2014 at 2:14 AM, Valorie Zimmerman valorie.zimmer...@gmail.com wrote: Time is short, so this is the last time I'll write. Think about what you want in your Frameworks book and commit to making it happen. Valorie 1. https://sprints.kde.org/sprint/212 but I think we have enough people signed up to to make this happen! Thanks to all of you who have stepped forward. I've created a wiki page here: http://community.kde.org/KDE_Documentation/KdeBooks#KDE_Books to begin gathering ideas/recipes. As you have thoughts and ideas, whether or not you'll be attending, write them up, please. Of course we'd like to have possible 'problems which can be solved by a framework or two' for each of the frameworks. We want ALL the ideas now, and pick and choose only the best for our book. Write out your idea even if it seems weak -- it might spark an idea for someone else. Valorie -- http://community.kde.org/KDE_Documentation/KdeBooks#KDE_Books ___ Kde-frameworks-devel mailing list Kde-frameworks-devel@kde.org https://mail.kde.org/mailman/listinfo/kde-frameworks-devel
Re: Re: Writing a Frameworks book at Randa
On Thu, Apr 10, 2014 at 9:23 PM, David Narvaez david.narv...@computer.org wrote: On Thu, Apr 10, 2014 at 5:02 AM, Martin Gräßlin mgraess...@kde.org wrote: we might have here a chicken-egg problem. Good API documentation would significantly help for writing the book. That is if the API documentation is good someone without deep domain knowledge will be able to write a book about it. But if the API documentation is not good enough it needs domain knowledge to write those. Now what I read out of the thread is that developers think that the time of the domain experts would be better spent writing the API documentation than writing a book. The question now is whether our API documentation is already good enough to write a book without domain experts or if we need to improve the documentation first, whether we could do this at the sprint instead of (or in addition) to writing a book. I have been thinking these are two orthogonal things. These are thoughts I had when this idea was first posted and may be relevant to this current discussion: O'Reilly media has these series of cookbooks. So you have * Programming in Perl[0]: Programming Perl, hit the shelves in 1990, and was quickly adopted as the undisputed bible of the language * Perl Cookbook[1]: The Perl Cookbook is a comprehensive collection of problems, solutions, and practical examples for anyone programming in Perl. I would presonally like us to have a Frameworks Cookbook after Randa, not a Frameworks Bible. Those bible textbooks are the ones that deprecate next month, that are always racing with apidocs and that never actually cover every possible thing a library has to offer. Cookbooks, on the other hand, go straight to the point of solving concrete problems, and while specific code snippets may end up being deprecated in time, the idea of I can solve this problem by mashing up these 3 frameworks will be essentially valid for a longer time. Plus, I think the cool idea of Frameworks is that they are useful for general problem solving, so lets market them using real problems. If people like this idea, then we can spend some time coming up with problems you can solve using Frameworks and then take (pre?-)Randa time to solve them, then write those solutions in the book. David E. Narvaez [0] http://shop.oreilly.com/product/9780596000271.do [1] http://shop.oreilly.com/product/9781565922433.do I used to bake bread for the family as fast as we ate it. I had a grain grinder and got raw milk, so there was fresh butter to put on that hot-from-the-oven whole wheat bread! It makes my mouth water to remember the smell of the bread as the kids broke that first loaf into pieces, when it was too hot to slice. What made that bread delicious were good ingredients, some work, and time. Bread can't be made without flour, liquid, yeast, salt, kneading, and time rising, and baking. I was happy to see that Cornelius has registered for the Randa sprint [1] and put at his first task, writing the book. We need a couple more people to sign up, or add KDEbooks as a secondary task, to knead and bake ourselves a wonderful book. Time is short, so this is the last time I'll write. Think about what you want in your Frameworks book and commit to making it happen. Valorie 1. https://sprints.kde.org/sprint/212 -- http://about.me/valoriez ___ Kde-frameworks-devel mailing list Kde-frameworks-devel@kde.org https://mail.kde.org/mailman/listinfo/kde-frameworks-devel
Re: Re: Re: Writing a Frameworks book at Randa
On Sun, Apr 13, 2014 at 10:38 PM, Martin Gräßlin mgraess...@kde.org wrote: On Friday 11 April 2014 00:23:26 David Narvaez wrote: On Thu, Apr 10, 2014 at 5:02 AM, Martin Gräßlin mgraess...@kde.org wrote: we might have here a chicken-egg problem. Good API documentation would significantly help for writing the book. That is if the API documentation is good someone without deep domain knowledge will be able to write a book about it. But if the API documentation is not good enough it needs domain knowledge to write those. Now what I read out of the thread is that developers think that the time of the domain experts would be better spent writing the API documentation than writing a book. The question now is whether our API documentation is already good enough to write a book without domain experts or if we need to improve the documentation first, whether we could do this at the sprint instead of (or in addition) to writing a book. I have been thinking these are two orthogonal things. These are thoughts I had when this idea was first posted and may be relevant to this current discussion: O'Reilly media has these series of cookbooks. So you have * Programming in Perl[0]: Programming Perl, hit the shelves in 1990, and was quickly adopted as the undisputed bible of the language * Perl Cookbook[1]: The Perl Cookbook is a comprehensive collection of problems, solutions, and practical examples for anyone programming in Perl. I would presonally like us to have a Frameworks Cookbook after Randa, not a Frameworks Bible. Fully agree and that's what I hoped the book would be about. But it's something which requires domain knowledge. E.g. examples for KWindowSystems need someone to really know what the framework is doing to just come up with a good idea for such a recipe. I wouldn't mind to collect ideas and solutions over the time, but it's too late to do it at the sprint. Cheers Martin I was excited to hear David Narvaez' ideas about what the book should be. It sounds like the focus is happening. However, not many people have committed to come to Randa and get this book started. Right now there is one person on https://sprints.kde.org/sprint/212 listing kdebooks as their task. I can ask other people to come to Randa to help shape the text, but we *must* have Frameworks people committed to this project to make it happen. The deadline for signing up is approaching. Please sign up now if you intend to come to write. The e.V. and other funders will support us if we step up; but I will not waste their money by flying to Switzerland without a committed group of writers. Valorie -- http://about.me/valoriez ___ Kde-frameworks-devel mailing list Kde-frameworks-devel@kde.org https://mail.kde.org/mailman/listinfo/kde-frameworks-devel
Re: Writing a Frameworks book at Randa
On Thu, Apr 10, 2014 at 1:26 AM, Aurélien Gâteau agat...@kde.org wrote: On Wed, Apr 9, 2014, at 6:05, Kevin Funk wrote: On Wednesday 09 April 2014 02:25:18 Valorie Zimmerman wrote: Hello folks, I know that August is months away, but if you want your Frameworks book, now is the time to step forward. Here are some things to think about: Most of this book is already written somewhere. When the words have already been written down, all we need do is gather and arrange them. When you think of such an email, dot story, blog post or have eloquent thoughts in your head, please make a note. If you are on this list, you are an expert. You know what the Frameworks will do for KDE, and you know what they *can* do for others. Our book will present that case. A good book will help grow the Frameworks team; I'm sure of it. And a good book will make your work more widely used. Oh, and you'll be a published author! While in Randa, none of us will be writing full-time. In fact, I hope that *all* of the Frameworks people will stop by the writing room, or log into Booki and review, add, re-arrange, correct, or make the text more graceful. To make this work a few people must volunteer to take on the writing of the book as their most important task at Randa. It will be mine, and our goal is to have a book by the end of the week. We've done it before, and I know we can do it again. This is a valuable work. We need to know the core members of this team, soon. Please step forward, and also add yourself to the Spints page for planning and funding. Valorie Hey, I'm wondering if we should rather try spending the time in making our KF5 apidocs shine. You could spend plenty of time on writing introductory parts for the individual modules, writing tutorials and examples, and make sure they're easy to reach and grasp for newcomers on apidocs.kde.org. This is an integral part for the docs on qt-project.org, too. Just have a look at the first hit for qt docs: [1] I agree with this. I think api docs have a higher chance of remaining relevant than a book. Aurélien There is no denying that apidox are crucially important. And I hope that some of what we write can contribute to that, perhaps. But I am in no way qualified to write those, while I am qualified to help this team write a book. Members of the team spoke up and felt that that was a useful thing to do. Obviously the audience we'd write for would be heading for the apidox once they got interested enough to investigate the frameworks for their projects. A book can only be introductory, for the reasons you all have stated. Valorie -- http://about.me/valoriez ___ Kde-frameworks-devel mailing list Kde-frameworks-devel@kde.org https://mail.kde.org/mailman/listinfo/kde-frameworks-devel
Writing a Frameworks book at Randa
Hello folks, I know that August is months away, but if you want your Frameworks book, now is the time to step forward. Here are some things to think about: Most of this book is already written somewhere. When the words have already been written down, all we need do is gather and arrange them. When you think of such an email, dot story, blog post or have eloquent thoughts in your head, please make a note. If you are on this list, you are an expert. You know what the Frameworks will do for KDE, and you know what they *can* do for others. Our book will present that case. A good book will help grow the Frameworks team; I'm sure of it. And a good book will make your work more widely used. Oh, and you'll be a published author! While in Randa, none of us will be writing full-time. In fact, I hope that *all* of the Frameworks people will stop by the writing room, or log into Booki and review, add, re-arrange, correct, or make the text more graceful. To make this work a few people must volunteer to take on the writing of the book as their most important task at Randa. It will be mine, and our goal is to have a book by the end of the week. We've done it before, and I know we can do it again. This is a valuable work. We need to know the core members of this team, soon. Please step forward, and also add yourself to the Spints page for planning and funding. Valorie -- http://about.me/valoriez ___ Kde-frameworks-devel mailing list Kde-frameworks-devel@kde.org https://mail.kde.org/mailman/listinfo/kde-frameworks-devel
Re: Frameworks book
On Sun, Mar 16, 2014 at 3:50 AM, David Faure fa...@kde.org wrote: On Saturday 15 March 2014 02:08:52 Valorie Zimmerman wrote: Hello frameworks developers, It has been discussed on the KDE-Community list that some of you would like a Frameworks book. I would strongly suggest that this is not ONLY a paper book but also an online book where updates get published, e.g. like the french Qt5 book works. Otherwise in 2 years it's only good for lighting a fire. /me remembers writing chapters in a book about KDE 2.0 which never got updated... quite a waste. Anyhow - no time for writing. At most I can review some text about the frameworks I know most about. Yes, just like the new developer manual, we'll be writing the book using the Booki web application on the Flossmanuals site at http://www.flossmanuals.net/. One can download the book, or order it in paper from Lulu.com. I'd rather read such a book on my Kindle than on dead trees! And I think most of our prospective audience will as well. Flossmanuals books can easily be updated, either to correct small errors, or to publish entire new editions. For those like David who will not have time to write, it is worth sending us your thoughts on what should be included, and any other relevant information. Remember, I can only edit and inspire. :-) Valorie -- http://about.me/valoriez ___ Kde-frameworks-devel mailing list Kde-frameworks-devel@kde.org https://mail.kde.org/mailman/listinfo/kde-frameworks-devel
Frameworks book
Hello frameworks developers, It has been discussed on the KDE-Community list that some of you would like a Frameworks book. While I've co-authored a book for KDE, the Developer Guide for our GSoC students, I'm no coder. So I need co-authors. Mario has asked me to head up the book sprint at Randa this August, and if enough of you are interested, we can write the book that week, Saturday, 9th to Friday, 15th of August 2014. We'll need a minimum of three writers, and more would be good. Don't worry about your skill in writing; what we need are energy, knowledge of the subject, and the ability to focus. My role will be to keep us on track, and to polish the writing. And of course we can copy from the wikis, emails and blog posts -- there is no need to have every word written in Randa. The most important part of this effort is narrowing the focus of the book by deciding for whom we are writing. I'm guessing other developers, but the more precise we are, the better the book will be. A great book will be wonderful advertising for the amazing effort you devels have put in transforming KDE-libs into KDE Frameworks. If you have time to come to Randa this August, please respond here on the list, and register for the sprint. For more information, see: http://randa-meetings.ch/2014/02/19/randa-meetings-2014-the-date-is-set-please-register/ https://sprints.kde.org/sprint/212 Valorie -- http://about.me/valoriez ___ Kde-frameworks-devel mailing list Kde-frameworks-devel@kde.org https://mail.kde.org/mailman/listinfo/kde-frameworks-devel