127 | | - PR procedures and status of the too many open PRs |
128 | | - ProjPicker (2.5 years old PR): https://github.com/OSGeo/grass/pull/1891 |
| 127 | * Documentation |
| 128 | * GRASS docs are falling behind, many pages lack examples and screenshots |
| 129 | * Suggestion: migrate HTML docs to markdown; MN already did some testing. |
| 130 | * We have now –md-description in g.parser to auto-generate the module description in markdown |
| 131 | * Next is to convert all html pages to markdown |
| 132 | * Use mkdocs (or similar) style then as it offers build-in search engine |
| 133 | * Jupyter notebooks with examples stored with modules would make running examples and testing so much easier |
130 | | - Documentation |
131 | | - GRASS docs are falling behind, many pages lack examples and screenshots |
132 | | - Suggestion: migrate HTML docs to markdown |
133 | | - we have now –md-description in g.parser to auto-generate the module description in markdown |
134 | | - next is to convert all html pages to markdown |
135 | | - use mkdocs (or similar) style then as it offers build-in search engine |
136 | | - jupyter notebooks with examples stored with modules would make running examples and testing so much easier |
137 | | |
138 | | - Discourse migration? |
139 | | - Apparently (young) newcomers do not use mailing list, we see a decline in subscriptions. |
140 | | - In theory, discourse can be used as the mailing list after first sign up in discourse and configuration. See [example https://forum.comses.net/top?period=daily]. |
141 | | - please let us keep the long history! (MN: mbox with all history file can possibly be imported, currently investigated) |
142 | | - attempts to make cross posting possible |
143 | | - mailman3 (example archive, also Fedora mailman3) which looks more modern than mailman2 is for some reason not in the table of OSGeo-SAC |
144 | | - we wait until issues are solved, especially history and proper cross-posting |
145 | | - OSGeo-Ticket: Migrate mailing lists to Mailman3: https://trac.osgeo.org/osgeo/ticket/3028 |
146 | | - BTW, my comment in the Trac ticket on mailman3 also arrived on discourse: |
147 | | https://discourse.osgeo.org/t/osgeo-3028-migrate-mailing-lists-to-mailman3/4698/2 |
148 | | - from Eduard: https://comm.collab.science.gc.ca/mailman3/hyperkitty/list/dd_info@comm.collab.science.gc.ca/message/D3NOHOMNEC6LDEQSJJRKC2TWIMEL3AHE/ |
149 | | https://comm.collab.science.gc.ca/mailman3/hyperkitty/list/dd_info@comm.collab.science.gc.ca/thread/23J7UBPTAIBAVDTUUEEWSBKR2HC4UP6J/ |
| 135 | * Discourse migration |
| 136 | * Apparently (young) newcomers do not use mailing list, we see a decline in subscriptions. |
| 137 | * In theory, discourse can be used as the mailing list after first sign up in discourse and configuration. See [https://forum.comses.net/top?period=daily example]. There have also been attempts to make cross posting possible. |
| 138 | * We all agree that keeping our history is most relevant. MN mentioned mbox with all history file can possibly be imported, currently under investigation. |
| 139 | * mailman3 ([https://lists.mailman3.org/archives/list/mailman-users@mailman3.org/ example archive], also [https://discussion.fedoraproject.org/c/news/5 Fedora mailman3]) which looks more modern than mailman2 is for some reason not in the table of OSGeo-SAC |
| 140 | * OSGeo-Ticket: Migrate mailing lists to Mailman3: https://trac.osgeo.org/osgeo/ticket/3028 |
| 141 | * MN's comment in the Trac ticket on mailman3 also arrived on discourse: https://discourse.osgeo.org/t/osgeo-3028-migrate-mailing-lists-to-mailman3/4698/2 |
| 142 | * We will wait until issues are solved, especially history and proper cross-posting. Meanwhile we can experiment by subscribing to some category, eg. OSGeo-SAC. |