Hi,<br><br>Le mardi 13 juin 2017, Yves Jacolin <<a href="mailto:yjacolin@free.fr">yjacolin@free.fr</a>> a écrit :<br>> Harrissou, Alexandre, and all :)<br>><br>> This wish list is great and interesting but really challenging. I have some<br>> idea about highest priority but we need to find a good way for discussion.<br><br>I've been asked by Paolo (the PSC?) to schedule a meeting to specifically discuss documentation needs and projects. While I did nothing yet (sorry Paolo for my silence - I am a bit busy these weeks), it sounds like a good approach to have these issues discussed in an efficient way. Now, questions: when? how? expected duration? Who is interested? Any suggestions of platform (honestly, a chat room could be easier to reach for me than a vocal call (not at work hours) because it has less constraints for me and with my accent in English I can't guarantee you understand me and I'm neither sure that my ears are enough used to English (accents) :( )?<br><br>> Here<br>> my though (draft for now):<br>><br>> * [june] move all tickets on PyQGIS to 3.0 and close the ones that don't make<br>> sense to keep (hard to know if we don't have knowledge on PyQGIS API)<br><br>I'd rather let them with their original milestone. I think we all agree that Documentation of pyqgis won't/can't be fixed in 2.18 but is a must-have in 3.x doc. I wonder if keeping initial milestone wouldn't help the Cookbook writers quickly identify obsolete issue reports when time comes (thing I am not able to do). I remember we had two interesting grant proposals to fix Cookbook for QGIS3.<br><br>> * [july] finish the 2.18 documentation, we are almost done but we need some<br>> time. I have, at least, 2-3 tickets to finalize or start for  the 2.18<br><br>And there are some pull requests that need review, particularly <a href="https://github.com/qgis/QGIS-Documentation/pull/1938">https://github.com/qgis/QGIS-Documentation/pull/1938</a> which imho could help fix many other issues.<br>Btw did we set a deadline for 2.18 release?<br><br>> * [june-august] create tickets (with special flags) for all you want to see in<br>> QGIS 3.0, add it in QGIS3 milestone. We can probably use "project" [1] feature<br>> on github and create  "new", "on discussion", "todo", "need review", "done"<br>> steps.<br><br>Do we release a 3.0 doc?<br>Tickets are already targeted, including 3.0 (milestone) ones. I might misunderstand how the project feature works but we do use a *blocker* label to identify what needs to be filled before release. Do you think we need another organization on this?<br><br>Anyway, please feel free to complete the wiki I began with your inputs so that we have a single place for subjects to discuss...<br><br>Thanks,<br>Harrissou<br><br>> * [july-september] vote/discuss on each tickets<br>><br>> We should improve planning (summer holidays will really slow down the work)<br>> and define the process. Could you give your though (Alexandre)?<br>><br>> Regards,<br>><br>> Y.<br>> [1] <a href="https://github.com/qgis/QGIS-Documentation/projects">https://github.com/qgis/QGIS-Documentation/projects</a><br>><br>> On dimanche 4 juin 2017 20:36:14 CEST DelazJ wrote:<br>>>  Hi,<br>>><br>>> A month later, could be nice to revive this thread and discuss ideas to<br>>> improve QGIS Docs...<br>>> Some of the top topics imho could be :<br>>> - release of 2.18 docs:  If I'm not wrong, the May release was supposed to<br>>> be the new LTR then I guess, given issues that occurred, the LTR release<br>>> will be June's. Are we ready? Status of remaining issues/PR?<br>>> - QGIS3 and link to online documentation (aka the new help system): how<br>>> could we ensure the best experience to the users? Collaboration with dev<br>>> team?<br>>> - Strategy to have the documentation budget always used each year, because<br>>> QGIS documentation has needs and projects (right?).<br>>><br>>> I've listed some items that I have in mind and somehow appear to me like<br>>> issues or questions to answer. They are referenced in a wiki page of my<br>>> repository (<a href="https://github.com/DelazJ/QGIS-Documentation/wiki/On-the-ro">https://github.com/DelazJ/QGIS-Documentation/wiki/On-the-ro</a><br>>> ad-to-QGIS3 - a kind of quick cheat sheet). If valuable, we can use it as a<br>>> basis and improve/clean it and produce a more structured and shared doc,<br>>> maybe in the QGIS Doc wiki (I don't really know what is its current status<br>>> - could we put things on it?).<br>>> The main idea would be to come up with plans, strategy or call it the way<br>>> you want we could submit to PSC and dev list (our priorities, what we do<br>>> need help for?...). Another option could be to discuss directly the points<br>>> in (one of?) those lists but I'm afraid, we miss the prioritization step :(<br>>><br>>> regards,<br>>> Harrissou<br>>><br>>> 2017-05-01 20:03 GMT+02:00 Alexandre Neto <<a href="mailto:senhor.neto@gmail.com">senhor.neto@gmail.com</a>>:<br>>> > It would be great if we have some help from a developer to tackle the<br>>> > PyQGIS Cookbook issues. I will probably take too much time to make user<br>>> > I'm<br>>> > documenting it correctly...<br>>> ><br>>> > I would leave big changes in documentation structure to 3.0 milestone. It<br>>> > might be the perfect time for "breaking" the documentation. There will be<br>>> > features documentation that will need to be revisited several times<br>>> > because<br>>> > of all the changes. During that time, it may be the perfect time for us to<br>>> > do a stand by in documenting new features and draw a plan for moving stuff<br>>> > around.<br>>> ><br>>> > Thanks<br>>> ><br>>> > Alex<br>>> ><br>>> > DelazJ <<a href="mailto:delazj@gmail.com">delazj@gmail.com</a>> escreveu no dia segunda, 1/05/2017 às 15:15:<br>>> >> Hi,<br>>> >><br>>> >> 2017-05-01 15:55 GMT+02:00 Alexandre Neto <<a href="mailto:senhor.neto@gmail.com">senhor.neto@gmail.com</a>>:<br>>> >>> Hello Yves,<br>>> >>><br>>> >>> Thanks for all your work this weekend. I tried to keep up and do some<br>>> >>> work, but it was a family tagged weekend :-)<br>>> >>><br>>> >>> Indeed, we had a superYves this hackfest. I also had difficulties in<br>>> >><br>>> >> following his rhythm. Nice work!!!<br>>> >><br>>> >>> I will try to put some more work this week into solving 2.16 and 2.18<br>>> >>> issues.<br>>> >>><br>>> >>> Do we have a hard deadline for 2.18 documentation? I would say we can<br>>> >>> keep work on it until 2.18 becomes LTR (June?).<br>>> >>><br>>> >>> Agreed, while it's a good thing to keep this level (or a bit slower :)<br>>> >><br>>> >> ?) of production, there's no hard deadline for 2.18 and I can't ensure<br>>> >> that<br>>> >> I'll be available on demand (but still, will do my best)<br>>> >><br>>> >> Also note that some no milestoned issues can/should be fixed if we have<br>>> >> time and energy before the release. They are not milestoned as 2.16or<br>>> >> 2.18<br>>> >> either because they are infrastructure issues or they are there for a<br>>> >> long<br>>> >> time in many releases.<br>>> >> We should count them in remaining issues for a clean and total 2.18<br>>> >> release.<br>>> >><br>>> >> anyway, all this is promising for 3.x releases...<br>>> >><br>>> >> Thanks,<br>>> >> Harrissou<br>>> >><br>>> >>> Thanks<br>>> >>><br>>> >>> Alex Neto<br>>> >>><br>>> >>> Yves Jacolin <<a href="mailto:yjacolin@free.fr">yjacolin@free.fr</a>> escreveu no dia segunda, 1/05/2017 às<br>>> >>><br>>> >>> 14:40:<br>>> >>>> Hello doc contributors,<br>>> >>>><br>>> >>>> Finishing the hackfest we are close to release the 2.18 release of the<br>>> >>>> QGIS<br>>> >>>> Documentation.<br>>> >>>><br>>> >>>> I planned to work on this all the week to finish my PR waiting to be<br>>> >>>> merged and<br>>> >>>> backporting to master/release_2_18, reviewing PR.<br>>> >>>><br>>> >>>> Are people available to help reviewing and merging PR? Are you ok to<br>>> >>>> focus on<br>>> >>>> issue in 2.16 and 2.18 milestone for this week?<br>>> >>>><br>>> >>>> A side note when reviewing, could you use github tools with the<br>>> >>>> following:<br>>> >>>><br>>> >>>> 1. if you add one comment (even really smal) note the Pr as "changes<br>>> >>>> needed "<br>>> >>>> 2. if the PR is ok (not any comment) mark it as "Approved"<br>>> >>>> 3. if you start a review, assign the ticket to you as a reviewer and<br>>> >>>> keep the<br>>> >>>> work going as soon as the PR is merged.<br>>> >>>><br>>> >>>> Finally, we have 10 open issues in 2.16 and 2 in 2.18 about python<br>>> >>>> cookbook. I<br>>> >>>> am in favor to migrate them to milestone 3.0 except someone can take<br>>> >>>> care of<br>>> >>>> it soon.<br>>> >>>><br>>> >>>> We had also 3 ticket in 2.18 that I can take care of: #1353, #1835 and<br>>> >>>> #1579.<br>>> >>>> If you want to help working on this ticket, fell free to ask!<br>>> >>>><br>>> >>>> Thanks all for your help for the documentation!<br>>> >>>><br>>> >>>> Y._______________________________________________<br>>> >>>> Qgis-community-team mailing list for organizing community resources<br>>> >>>> such as documentation, translation etc..<br>>> >>>> <a href="mailto:Qgis-community-team@lists.osgeo.org">Qgis-community-team@lists.osgeo.org</a><br>>> >>>> <a href="https://lists.osgeo.org/mailman/listinfo/qgis-community-team">https://lists.osgeo.org/mailman/listinfo/qgis-community-team</a><br>>> >>><br>>> >>> --<br>>> >>> Alexandre Neto<br>>> >>> ---------------------<br>>> >>> @AlexNetoGeo<br>>> >>> <a href="http://sigsemgrilhetas.wordpress.com">http://sigsemgrilhetas.wordpress.com</a><br>>> >>> <a href="http://gisunchained.wordpress.com">http://gisunchained.wordpress.com</a><br>>> >>><br>>> >>> _______________________________________________<br>>> >>> Qgis-community-team mailing list for organizing community resources such<br>>> >>> as documentation, translation etc..<br>>> >>> <a href="mailto:Qgis-community-team@lists.osgeo.org">Qgis-community-team@lists.osgeo.org</a><br>>> >>> <a href="https://lists.osgeo.org/mailman/listinfo/qgis-community-team">https://lists.osgeo.org/mailman/listinfo/qgis-community-team</a><br>>> >><br>>> >> --<br>>> ><br>>> > Alexandre Neto<br>>> > ---------------------<br>>> > @AlexNetoGeo<br>>> > <a href="http://sigsemgrilhetas.wordpress.com">http://sigsemgrilhetas.wordpress.com</a><br>>> > <a href="http://gisunchained.wordpress.com">http://gisunchained.wordpress.com</a><br>><br>>