Skip to content

Commit

Permalink
17524 resources content pt2 (#175)
Browse files Browse the repository at this point in the history
* add FAQ, spoiler.js, reports, fix donate-prompt logic

* fix render hook for ref shortcode, add tests page

* cleanup links

* add List of Releases

* add automation for Roadmap
  • Loading branch information
sleeping-h authored Feb 22, 2024
1 parent 8927bd0 commit e101537
Show file tree
Hide file tree
Showing 21 changed files with 1,434 additions and 108 deletions.
16 changes: 14 additions & 2 deletions config.toml
Original file line number Diff line number Diff line change
Expand Up @@ -369,6 +369,18 @@ sectionPagesMenu = 'main'
url = "/resources/releases/"
weight = 30

[[menu.main]]
parent = "Releases"
name = "List of releases"
url = "/resources/releases/"
weight = 30

[[menu.main]]
parent = "Releases"
name = "Tests"
url = "/resources/releases/#tests"
weight = 30

[[menu.main]]
parent = "Resources"
name = "Roadmap"
Expand All @@ -384,7 +396,7 @@ sectionPagesMenu = 'main'
[[menu.main]]
parent = "Reports"
name = "OGC Certification"
url = "/resources/ogc-certification/"
url = "/resources/reports/#ogc-certification"
weight = 60

[[menu.main]]
Expand Down Expand Up @@ -414,7 +426,7 @@ sectionPagesMenu = 'main'
[[menu.main]]
parent = "Support"
name = "FAQ"
url = "/resources/support/#faq"
url = "/resources/support/faq"
weight = 110

[[menu.main]]
Expand Down
2 changes: 2 additions & 0 deletions content/download/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -88,4 +88,6 @@ For testing and learning purposes, [a sample dataset is available](https://docs.

{{< /download-platforms >}}

{{< script src="js/spoiler.js" >}}

{{< content-end >}}
2 changes: 1 addition & 1 deletion content/resources/installation-guide/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -161,7 +161,7 @@ Our main repository contains multiple lines of packages for several versions of

For Ubuntu we also used to have extra packages in a separate repository that are based on [ubuntugis](https://launchpad.net/~ubuntugis), which held more uptodate versions of other GIS packages than Ubuntu itself for LTS versions. If you want those you also need to include ubuntugis-unstable ppa in your /etc/apt/sources.list.d/qgis.list file (see [ubuntugis documentation](https://trac.osgeo.org/ubuntugis/wiki/UbuntuGISRepository)).

{{< rich-box icon="💁" layoutClass="tips">}}
{{< rich-box icon="💁" layoutClass="tips" mode="html" >}}
{{< rich-content themeClass="coloring-1" >}}
##### Note
The release packages are only produced once shortly after a new version has been released. As unstable, not yet released debian versions (testing) and ubuntugis-unstable can have library changes the packages might sooner or later be broken for these targets, when the development in debian, ubuntu or ubuntugis-unstable moves on and their packages used as dependencies in qgis change. In that event you can either
Expand Down
42 changes: 42 additions & 0 deletions content/resources/releases.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,42 @@
---
type: "page"
title: "Releases"
subtitle: ""
draft: false
sidebar: true
---

{{< content-start >}}

# List of Releases

Previous releases of QGIS are still available [here](https://qgis.org/downloads) - including older releases for OS X [here](https://qgis.org/downloads/macOS/).

More older releases are available [here](https://download.osgeo.org/qgis/) and for OS X [here](https://www.kyngchaos.com/software/archive/).

Plugins for QGIS are also available [here](https://plugins.qgis.org/plugins/).

# Tests

Both QGIS and QGIS server are being tested via all kind of ways.

From build tests (github workflows) and code unit tests to OGC conformance testing.


<a href="https://github.com/qgis/QGIS/actions/workflows/run-tests.yml?query=branch%3Amaster+event%3Apush" target="_blank">
<img src="https://github.com/qgis/QGIS/actions/workflows/run-tests.yml/badge.svg">
</a>

<a href="https://hub.docker.com/r/qgis/qgis/tags" target="_blank">
<img src="https://img.shields.io/docker/automated/qgis/qgis.svg">
</a>


See [Unit testing](https://docs.qgis.org/testing/en/docs/developers_guide/unittesting.html)


See [OGC conformance testing](https://docs.qgis.org/testing/en/docs/developers_guide/ogcconformancetesting.html) for more information and how to run these tests yourself.

Recent tests output can be found here: http://test.qgis.org/ogc_cite. For latest WMS 1.3.0 test see http://test.qgis.org/ogc_cite/wms_130/latest/report.html and for WFS 1.1.0 see http://test.qgis.org/ogc_cite/wfs_110/latest/report.html.

{{< content-end >}}
26 changes: 24 additions & 2 deletions content/resources/reports/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,29 @@ sidebar: true

Some reports are generated on a daily basis to monitor the status of QGIS Server.

- [OGC Certification](https://qgis.org/en/site/getinvolved/daily_reports/ogc.html)
- [Performance](https://qgis.org/en/site/getinvolved/daily_reports/performance.html)
## OGC Certification

QGIS Server 3.28 is currently certified for WMS 1.3.0 (see [OGC Reference Implementation](http://www.opengeospatial.org/resource/products)).

![](qgis_server_wms_ogc_badge.png)

In order to keep an eye on regressions, OGC tests are run on a daily basis on the **master** branch. Corresponding reports are generated for several OGC testsuites:

- WMS 1.3.0 : http://test.qgis.org/ogc_cite/wms_130/

- OGC API Features (aka WFS 3) : http://test.qgis.org/ogc_cite/ogcapif/

- WFS 1.1.0 : http://test.qgis.org/ogc_cite/wfs_110/


Latest reports are [WMS 1.3.0](http://test.qgis.org/ogc_cite/wms_130/latest/report.html) and [WFS 1.1.0](http://test.qgis.org/ogc_cite/wfs_110/latest/report.html).

## Performance

At the moment, two tools are living together to test and generate performance reports.

The first one is [MS-Perfs](https://github.com/camptocamp/ms_perfs) which allows to compare QGIS Server with other map servers (like GeoServer or MapServer). Reports are generated weekly and available [here](http://test.qgis.org/perf_test/ms_perf/).

The second one is [Graffiti](https://github.com/pblottiere/graffiti), allowing to generate a performance report between several versions of QGIS Server and/or specific project options (parallel rendering effect, trust option, and so on). Reports are also generated daily and available [in](http://test.qgis.org/perf_test/graffiti/). Note that [QGIS-Server-PerfSuite](https://github.com/Oslandia/QGIS-Server-PerfSuite) project is the deployment infrastructure to run Graffiti in continuous integration.

{{< content-end >}}
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
81 changes: 19 additions & 62 deletions content/resources/roadmap.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ In the development phase, developers work on adding new features for the next re

In the feature freeze phase, new features are not allowed in anymore and the focus of everyone moves from enhancing QGIS to stabilizing it. This also turns the nightly builds effectively into [prereleases](#qgis-prereleases).

**Users** should start extensive testing of these prereleases in their environment to verify that there are no issues, they wouldn’t want to see in the upcoming release. All such issues should be reported (see [Bugs, Features and Issues](https://qgis.org/en/site/getinvolved/development/bugreporting.html#qgis-bugreporting)). Everything that goes unnoticed, will also end up in the next release. Only in case of serious problems backports to a latest release will occur. Therefore testing of the prereleases and reporting issues is very important.
**Users** should start extensive testing of these prereleases in their environment to verify that there are no issues, they wouldn’t want to see in the upcoming release. All such issues should be reported (see [Bugs, Features and Issues]({{< ref "resources/support/bug-reporting" >}})). Everything that goes unnoticed, will also end up in the next release. Only in case of serious problems backports to a latest release will occur. Therefore testing of the prereleases and reporting issues is very important.

In the feature freeze, **developers** monitor the bugtracker and start working on fixing the reported issues and update the **visual changelog** with the features they added.

Expand Down Expand Up @@ -58,71 +58,28 @@ In the first four months after its release, a new LTR is also the current LR. In

This schedule is also available as [“iCalendar”](https://qgis.org/schedule.ics).

Schedule

TODO: should be generated from CSV

|Event|Latest|Long-Term Repo|Freeze|Date|Week #|Weeks|
|---|---|---|---|---|---|---|
|LTR/PR|3.28.0|3.22.12||2022-10-21|43|4|
|PR|3.28.1|3.22.13||2022-11-18|47|4|
|PR|3.28.2|3.22.14||2022-12-16|51|6|
|PR/FF|3.28.3|3.22.15|3.29|2023-01-27|5|5|
|EPR||3.22.16||2023-02-03|6||
|LR/PR|3.30.0|3.28.4||2023-03-03|10|4|
|PR|3.30.1|3.28.5||2023-03-31|14|4|
|PR|3.30.2|3.28.6||2023-04-28|18|4|
|PR/FF|3.30.3|3.28.7|3.31|2023-05-26|22|4|
|LR/PR|3.32.0|3.28.8||2023-06-23|26|4|
|PR|3.32.1|3.28.9||2023-07-21|30|4|
|PR|3.32.2|3.28.10||2023-08-18|34|4|
|PR/FF|3.32.3|3.28.11|3.33|2023-09-15|38|6|
|LTR/PR|3.34.0|3.28.12||2023-10-27|44|4|
|PR|3.34.1|3.28.13||2023-11-24|48|4|
|PR|3.34.2|3.28.14||2023-12-22|52|4|
|PR/FF|3.34.3|3.28.15|3.35|2024-01-19|3|5|
|LR/PR|3.36.0|3.34.4||2024-02-23|8|4|
|PR|3.36.1|3.34.5||2024-03-22|12|4|
|PR|3.36.2|3.34.6||2024-04-19|16|4|
|PR/FF|3.36.3|3.34.7|3.37|2024-05-17|20|5|
|LR/PR|3.38.0|3.34.8||2024-06-21|25|4|
|PR|3.38.1|3.34.9||2024-07-19|29|4|
|PR|3.38.2|3.34.10||2024-08-16|33|4|
|PR/FF|3.38.3|3.34.11|3.39|2024-09-13|37|6|
|LTR/PR|3.40.0|3.34.12||2024-10-25|43|4|
|PR|3.40.1|3.34.13||2024-11-22|47|4|
|PR|3.40.2|3.34.14||2024-12-20|51|4|
|PR/FF|3.40.3|3.34.15|3.41|2025-01-17|3|5|
|LR/PR|3.42.0|3.40.4||2025-02-21|8|4|
|PR|3.42.1|3.40.5||2025-03-21|12|4|
|PR|3.42.2|3.40.6||2025-04-18|16|4|
|PR/FF|3.42.3|3.40.7|3.43|2025-05-16|20|5|
|LR/PR|3.44.0|3.40.8||2025-06-20|25|4|
|PR|3.44.1|3.40.9||2025-07-18|29|4|
|PR|3.44.2|3.40.10||2025-08-15|33|4|
|PR/FF|3.44.3|3.40.11|3.45|2025-09-12|37|6|
|LTR/PR|3.46.0|3.40.12||2025-10-24|43|4|
|PR|3.46.1|3.40.13||2025-11-21|47|4|
|PR|3.46.2|3.40.14||2025-12-19|51|4|
|PR/FF|3.46.3|3.40.15||2026-01-16|3|5|

Event legend
|Event|Description|
|---|---|
|LTR|Long term release, begin of new development phase|
|LR|Regular release, begin of new development phase|
|FF|Feature freeze, end of development phase|
|PR|Point release of latest release and LTR branch|
|EPR|Extra Point release|
|current|currently supported releases: 3.28.15 and 3.34.3|
|next|next releases|
### Schedule

{{< csv-table file="csv/schedule.csv" />}}

### Event legend

{{< csv-table >}}
"LTR","Long term release, begin of new development phase"
"LR","Regular release, begin of new development phase"
"FF","Feature freeze, end of development phase"
"PR","Point release of latest release and LTR branch"
"EPR","Extra Point release"
":rm-current:current",":rm-current:currently supported releases: |ltrrelease| and |release|"
":rm-next:next",":rm-next:next releases"
{{< /csv-table >}}

## Location of prereleases / nightly builds {#qgis-prereleases}

|Platform|Location|
|---|---|
|Windows|[OSGeo4W](../installation-guide/#qgis-windows-testing)|
|Linux|[Debian/Ubuntu](../installation-guide/#qgis-debian-testing)|
|MacOS|[Mac OS](../installation-guide/#qgis-macos-testing)|
|Windows|[OSGeo4W]({{< ref "resources/installation-guide#osgeo4w-installer" >}})|
|Linux|[Debian/Ubuntu]({{< ref "resources/installation-guide#repositories" >}})|
|MacOS|[Mac OS]({{< ref "resources/installation-guide#qgis-nightly-release" >}})|

{{< content-end >}}
24 changes: 10 additions & 14 deletions content/resources/support.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,47 +10,43 @@ sidebar: true

# Support

## FAQ

TODO https://qgis.org/en/site/getinvolved/faq/index.html#how-to-ask-a-qgis-question

## Mailing Lists

QGIS has a bunch of mailing lists. See [Mailing lists](https://qgis.org/en/site/getinvolved/mailinglists.html#qgis-mailinglists) for the different available lists.
QGIS has a bunch of mailing lists. See [Mailing lists]({{< ref "community/organisation/mailinglists" >}}) for the different available lists.

If you are going to ask questions please read this: [How to ask a QGIS question?](https://qgis.org/en/site/getinvolved/faq/index.html#how-to-ask-a-qgis-question).
If you are going to ask questions please read this: [How to ask a QGIS question?](faq/#how-to-ask-a-qgis-question).

## StackExchange

On [http://gis.stackexchange.com](http://gis.stackexchange.com) you can ask QGIS questions also. If you use the tag `qgis` you’ll see all QGIS related questions and answers: [http://gis.stackexchange.com/?tags=qgis](http://gis.stackexchange.com/?tags=qgis)
On http://gis.stackexchange.com you can ask QGIS questions also. If you use the tag `qgis` you’ll see all QGIS related questions and answers: http://gis.stackexchange.com/?tags=qgis

## Communication channels

### Telegram

There is a lot of user and community related chat (english spoken) on the Telegram channel you can join here: [https://t.me/joinchat/Aq2V5RPoxYYhXqUPoxRWPQ](https://t.me/joinchat/Aq2V5RPoxYYhXqUPoxRWPQ)
There is a lot of user and community related chat (english spoken) on the Telegram channel you can join here: https://t.me/joinchat/Aq2V5RPoxYYhXqUPoxRWPQ

To join: install Telegram on your phone, register and join via link above.

There is also a web version ([https://web.telegram.org](https://web.telegram.org)) which you can join in the browser (after you joined telegram via your phone(number)).
There is also a web version (https://web.telegram.org) which you can join in the browser (after you joined telegram via your phone(number)).

### Matrix / IRC

Matrix ([https://matrix.org](https://matrix.org)) is a project for decentralised chat. QGIS has a room accessible by the **#qgis:osgeo.org** alias (among others) which bridges to the libera.chat **#qgis** IRC channel.
Matrix (https://matrix.org) is a project for decentralised chat. QGIS has a room accessible by the **#qgis:osgeo.org** alias (among others) which bridges to the libera.chat **#qgis** IRC channel.

To use Matrix: create an account (at matrix.org is easiest, but if you have an OSGeo account you can also [use your OSGeo id as matrix id](https://wiki.osgeo.org/wiki/Matrix#Connecting_to_the_OSGeo_Matrix_Homeserver)), install a client (Elements is easiest, but see [https://matrix.org/docs/projects/try-matrix-now/#clients](https://matrix.org/docs/projects/try-matrix-now/#clients) for more), OR point your browser to [https://matrix.to/#/#qgis:osgeo.org](https://matrix.to/#/#qgis:osgeo.org)
To use Matrix: create an account (at matrix.org is easiest, but if you have an OSGeo account you can also [use your OSGeo id as matrix id](https://wiki.osgeo.org/wiki/Matrix#Connecting_to_the_OSGeo_Matrix_Homeserver)), install a client (Elements is easiest, but see https://matrix.org/docs/projects/try-matrix-now/#clients for more), OR point your browser to https://matrix.to/#/#qgis:osgeo.org

To use IRC: install an IRC client and connect to [irc://irc.libera.chat/#qgis](irc://irc.libera.chat/#qgis) or point your browser to [https://web.libera.chat/?channels=#qgis](https://web.libera.chat/?channels=#qgis)
To use IRC: install an IRC client and connect to irc://irc.libera.chat/#qgis or point your browser to https://web.libera.chat/?channels=#qgis

### Facebook

For Facebook users, an english-speaking global community group for QGIS users can be found at [https://www.facebook.com/groups/qgiscommunityofficialvirtualgroup](https://www.facebook.com/groups/qgiscommunityofficialvirtualgroup)
For Facebook users, an english-speaking global community group for QGIS users can be found at https://www.facebook.com/groups/qgiscommunityofficialvirtualgroup

## User Groups

Local QGIS user groups are a great place to meet other users.

See [User Groups](../../community/organisation/groups/) to read about it.
See [User Groups]({{< ref "community/organisation/groups" >}}) to read about it.

## Website

Expand Down
Loading

0 comments on commit e101537

Please sign in to comment.