[QGIS-Developer] Documentation repository looking for developers

[Tim Sutton]

Hi Harrisou!

Top posting here since I cannot address the items individually. We are in
the last stages of hiring a QGIS Jr Web Developer for one year under
funding from QGIS.org. I think quite a few of the things on your list below
are things we might be able to assign to the person we appoint. So I warmly
invite you to maybe do some collaboration with the person when they
'arrive' and we can assign them tasks that will help you.

One specific point on #3 below, Mathias Kuhn was working on some Transifex
cleverness at the Firence hackfest for the web site - maybe some of this
logic can also be ported to pull instead of push for the docs.
https://github.com/qgis/QGIS-Website/blob/master/.github/workflows/tx_push.yml


Regards

Tim


On Thu, Oct 20, 2022 at 10:07 AM DelazJ via QGIS-Developer <
qgis-developer at lists.osgeo.org> wrote:

>
> Hi dear devs,
>
> With feature freeze/bug fixes period almost finished, and before you get
> busy with pushing cool and nice features for the next 3.30 branch, I'd like
> to share with you a few cool features the documentation repo will also be
> really happy to get from your skills.
>
> *Code/Setup*
>
> 1. Create a github action to automatically assign labels to issue reports
> generated from merged pull requests in code repo, to help us quickly
> triage. See #50562 <https://github.com/qgis/QGIS/issues/50562> and #7826
> <https://github.com/qgis/QGIS-Documentation/issues/7826>
>
> 2. To the generated issue reports, we also have to assign the milestone,
> that is the next LTR we will document it in... An automatic assignment
> would also be great. See #7828
> <https://github.com/qgis/QGIS-Documentation/issues/7828>
>
> 3. If the move away from Transifex is not yet on the radar, a github
> action to regularly pull unfinished translation files would be welcome. See
> #7827 <https://github.com/qgis/QGIS-Documentation/issues/7827>
>
> 4. Help setup the release branches to allow automatic merge when tests
> pass. See #7837 <https://github.com/qgis/QGIS-Documentation/issues/7837>
>
> 5. Fix text frame width in the pyQGIS API documentation. See #36
> <https://github.com/qgis/pyqgis/issues/36>
>
> *Writing*
>
> If you instead feel like writing , there are some outdated, confusing
> instructions in the docs for beginners in coding:
>
> 1. how to configure python path
> <https://docs.qgis.org/testing/en/docs/pyqgis_developer_cookbook/intro.html>
> from within QGIS or custom application: See #6179
> <https://github.com/qgis/QGIS-Documentation/issues/6179> and attempts to
> fix it at #6306 <https://github.com/qgis/QGIS-Documentation/pull/6306>,
> #7139 <https://github.com/qgis/QGIS-Documentation/pull/7139> and #7140
> <https://github.com/qgis/QGIS-Documentation/pull/7140>
>
> 2. methods and tools to debug code/plugins: see #7836
> <https://github.com/qgis/QGIS-Documentation/issues/7836>
>
> 3. as usual, review of current pull requests
> <https://github.com/qgis/QGIS-Documentation/pulls> is still welcome
>
> *Triage*
>
> If you don't feel like coding nor writing, you can just tell us whether
> you think that any of these reports is worth documenting and how we could
> address it: ToDocOrNotToDoc
> <https://github.com/qgis/QGIS-Documentation/issues?q=is%3Aopen+is%3Aissue+label%3AToDocOrNotToDoc%3F>
>
> As you can see, the needs are diverse; it is about coding, setup, triaging
> and writing so you probably will find something for you (I hope) and do it
> faster than in my unsuccessful attempts.
> *The docs needs the devs*.
>
> Kind regards and looking forward,
> Harrissou
> _______________________________________________
> QGIS-Developer mailing list
> QGIS-Developer at lists.osgeo.org
> List info: https://lists.osgeo.org/mailman/listinfo/qgis-developer
> Unsubscribe: https://lists.osgeo.org/mailman/listinfo/qgis-developer
>


-- 
------------------------------------------------------------------------------------------

Tim Sutton
Visit http://kartoza.com to find out about open source:
 * Desktop GIS programming services
 * Geospatial web development
* GIS Training
* Consulting Services
Tim is a member of the QGIS Project Steering Committee
-------------------------------------------------------------------------------------------
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osgeo.org/pipermail/qgis-developer/attachments/20221105/aea1e441/attachment.htm>