<div dir="ltr"><div><div><div>Ah... I also forgot to mention that we need to clean up the issues list:<br></div>- some issues are not to be documented: given that we get anything that is tagged as "feature", even backend improvements or nice things (good enough for changelog) are reported in Docs repo. We need to remove them.<br>- some issues are reported cryptically ie using dev's vocabulary with qgs stuffs... things that may be understandable for people that follow QGIS repo but not obvious to newcomers. (add to that the "<i>Unfortunately this naughty coder did not write a description... :-(</i>" and people could be lost)<br><br></div>I feel that these are two areas we should work on if we want to offer an easy and nice integration to beginners. I could not personally spend time on this in upcoming two weeks. If someone else want to take the lead, thanks to him/her.<br><br></div>H.<br></div><div class="gmail_extra"><br><div class="gmail_quote">2017-12-04 12:52 GMT+01:00 DelazJ <span dir="ltr"><<a href="mailto:delazj@gmail.com" target="_blank">delazj@gmail.com</a>></span>:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div><div><div><div>Hi Tim,<br></div>Thanks for this draft. Some first thoughts:<br></div><div>- When mentioning the "Sphinx based documentation", maybe could we add link to documentation guidelines<br></div>- we could also mention that there some issue reports that are tagged "easy" to lower the barrier for beginners (if needed). Btw, it could be nice if some doc team members could review the list and check whether there could be more "easy"-tagged issues (I tried but i don't know all the areas of QGIS, hence can't always evaluate whether an issue is easy to fix or not).<br></div><div>- I saw a call recently (from Alexandre?) arguing that writing doc is a good way to learn new features. Maybe we could also use that argument to show them other nice side of writing.</div><div><br></div><div>Sorry to just come with "suggestions" instead of "rewriting".<br></div><div><br></div>Regards,<br></div>Harrissou<br></div><div class="HOEnZb"><div class="h5"><div class="gmail_extra"><br><div class="gmail_quote">2017-12-03 22:21 GMT+01:00 Tim Sutton <span dir="ltr"><<a href="mailto:tim@kartoza.com" target="_blank">tim@kartoza.com</a>></span>:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div style="word-wrap:break-word;line-break:after-white-space">Hi Yves and Harrisou<div><br></div><div>I have drafted a blog article to try to get more documentation help in for the QGIS 3.0 release. Could you guys review it and let me know if there is anything else you would like to add / change (text below).</div><div><br></div><div>Also just a reminder that there is budget for  supporting documentation - please use it if you can think of ways that money will productively improve and streamline the documentation process. Andreas can provide more details of available funs if needed. Draft text follows:</div><div><br></div><div><br></div><div><br></div><div>————</div><div><br></div><div>Documentation for QGIS 3.0 - call for contributions!</div><div><br></div><div><p>Dear QGIS users, enthusiasts and fine people out there. QGIS 3.0 is coming very soon....we are in a 'soft freeze' state at the moment while we wait for some critical last pieces of code to get finalised. Then we go into hard freeze and prepare to roll out our next major release. Those of you that have been playing with the '2.99' builds will surely have noticed that QGIS 3.0 is going to feature a huge number of improvements and new features - both in the user interface and in the API and code internals.</p><p style="text-align:center">But we have a <strong style="font-size:4em">BIG</strong> problem:<br>we need your <strong style="font-size:4em">help</strong> to document and <strong style="font-size:4em">describe</strong> all those fine new <strong style="font-size:4em">features!</strong></p><p>Yes fine reader now is the time to break out of the 'passive user of QGIS' mould you might find yourself in and lend a hand. We have an issue tracker with an <a href="https://github.com/qgis/QGIS-Documentation/issues?q=is%3Aopen+is%3Aissue+milestone%3A%22QGIS+3.0%22" target="_blank">issue for each of the new features</a> that has landed in QGIS 3.0. Even if you do not know how to use our Sphinx based documentation system, you can help tremendously by preparing the prose that should be used to describe new features and attaching it to the issue list linked to above. If you do that, the documentation team can do more editorial work and less  'writing from scratch' work. If you want to see the <a href="http://docs.qgis.org/2.18/en/docs/user_manual/" target="_blank">QGIS Documentation</a> up-to-date for the version 3.0 release, please do get involved and help Yves Jacolin and the documentation team!</p></div><div><br></div><div><br></div><div><br></div><div>———————</div><div><br></div><div>Regards</div><div><br></div><div><br></div><div><br><div>
<span style="color:rgb(0,0,0);font-family:Helvetica;font-size:18px;font-style:normal;font-variant-caps:normal;font-weight:normal;letter-spacing:normal;text-align:start;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px"> </span><span><img id="m_7074431291644476295m_-63147254378142331005C828E0-F8C8-4A26-BF3B-E096FD3E86DC" src="cid:B67F6A36-B856-4FD5-91BC-5BDE8990D373"></span><div style="color:rgb(0,0,0);font-family:Helvetica;font-style:normal;font-variant-caps:normal;font-weight:normal;letter-spacing:normal;text-align:start;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px;font-size:12px;font-variant-ligatures:normal;font-variant-numeric:normal;font-variant-alternates:normal;font-variant-east-asian:normal;line-height:normal;word-wrap:break-word"><div style="font-weight:normal"><br class="m_7074431291644476295m_-631472543781423310Apple-interchange-newline"><br class="m_7074431291644476295m_-631472543781423310Apple-interchange-newline"><br class="m_7074431291644476295m_-631472543781423310Apple-interchange-newline">---</div><div style="font-weight:normal"><br></div><div><b>Tim Sutton</b></div><div style="font-weight:normal">QGIS Project Steering Committee Chair</div><div style="font-weight:normal"><a href="mailto:tim@qgis.org" target="_blank">tim@qgis.org</a></div><div style="font-weight:normal"><br></div></div><br class="m_7074431291644476295m_-631472543781423310Apple-interchange-newline" style="color:rgb(0,0,0);font-family:Helvetica;font-style:normal;font-variant-caps:normal;font-weight:normal;letter-spacing:normal;text-align:start;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px;font-size:12px;font-variant-ligatures:normal;font-variant-numeric:normal;font-variant-alternates:normal;font-variant-east-asian:normal;line-height:normal"><br class="m_7074431291644476295m_-631472543781423310Apple-interchange-newline" style="color:rgb(0,0,0);font-family:Helvetica;font-style:normal;font-variant-caps:normal;font-weight:normal;letter-spacing:normal;text-align:start;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px;font-size:12px;font-variant-ligatures:normal;font-variant-numeric:normal;font-variant-alternates:normal;font-variant-east-asian:normal">
</div>

<br></div></div></blockquote></div><br></div>
</div></div></blockquote></div><br></div>