Add changelog to docs

NEWS.md

@@ -8,10 +8,10 @@ for human readability.
 
 #### Added
 - Implementation of `TimeSeriesCallback` for curvilinear meshes on `UnstructuredMesh2D` and extension
-  to 1D and 3D on `TreeMesh`.
-- Implementation of 1D Linearized Euler Equations.
-- New analysis callback for 2D `P4estMesh` to compute integrated quantities along a boundary surface, e.g., pressure lift and drag coefficients.
-- Optional tuple parameter for `GlmSpeedCallback` called `semi_indices` to specify for which semidiscretization of a `SemidiscretizationCoupled` we need to update the GLM speed.
+  to 1D and 3D on `TreeMesh` ([#1855], [#1873]).
+- Implementation of 1D Linearized Euler Equations ([#1867]).
+- New analysis callback for 2D `P4estMesh` to compute integrated quantities along a boundary surface, e.g., pressure lift and drag coefficients ([#1812]).
+- Optional tuple parameter for `GlmSpeedCallback` called `semi_indices` to specify for which semidiscretization of a `SemidiscretizationCoupled` we need to update the GLM speed ([#1835]).
 
 ## Changes when updating to v0.7 from v0.6.x
 
@@ -189,9 +189,8 @@ for human readability.
 #### Added
 
 - Experimental support for artificial neural network-based indicators for shock capturing and
-  adaptive mesh refinement ([#632](https://github.com/trixi-framework/Trixi.jl/pull/632))
-- Experimental support for direct-hybrid aeroacoustics simulations
-  ([#712](https://github.com/trixi-framework/Trixi.jl/pull/712))
+  adaptive mesh refinement ([#632])
+- Experimental support for direct-hybrid aeroacoustics simulations ([#712])
 - Implementation of shallow water equations in 2D
 - Experimental support for interactive visualization with [Makie.jl](https://makie.juliaplots.org/)
 
@@ -227,7 +226,7 @@ for human readability.
   - acoustic perturbation equations
   - Lattice-Boltzmann equations
 - Composable `FluxPlusDissipation` and `FluxLaxFriedrichs()`, `FluxHLL()` with adaptable
-  wave speed estimates were added in [#493](https://github.com/trixi-framework/Trixi.jl/pull/493)
+  wave speed estimates were added in [#493]
 - New structured, curvilinear, conforming mesh type `StructuredMesh`
 - New unstructured, curvilinear, conforming mesh type `UnstructuredMesh2D` in 2D
 - New unstructured, curvilinear, adaptive (non-conforming) mesh type `P4estMesh` in 2D and 3D
@@ -240,13 +239,13 @@ for human readability.
 - `flux_lax_friedrichs(u_ll, u_rr, orientation, equations::LatticeBoltzmannEquations2D)` and
   `flux_lax_friedrichs(u_ll, u_rr, orientation, equations::LatticeBoltzmannEquations3D)`
   were actually using the logic of `flux_godunov`. Thus, they were renamed accordingly
-  in [#493](https://github.com/trixi-framework/Trixi.jl/pull/493). This is considered a bugfix
+  in [#493]. This is considered a bugfix
   (released in Trixi.jl v0.3.22).
 - The required Julia version is updated to v1.6.
 
 #### Deprecated
 
-- `calcflux` → `flux` ([#463](https://github.com/trixi-framework/Trixi.jl/pull/463))
+- `calcflux` → `flux` ([#463])
 - `flux_upwind` → `flux_godunov`
 - `flux_hindenlang` → `flux_hindenlang_gassner`
 - Providing the keyword argument `solution_variables` of `SaveSolutionCallback`
@@ -258,6 +257,6 @@ for human readability.
   only a single two-point numerical flux for nonconservative is deprecated. The new
   interface is described in a tutorial. Now, a tuple of two numerical fluxes of the
   form `(conservative_flux, nonconservative_flux)` needs to be passed for
-  nonconservative equations, see [#657](https://github.com/trixi-framework/Trixi.jl/pull/657).
+  nonconservative equations, see [#657].
 
 #### Removed

docs/.gitignore

@@ -1,3 +1,4 @@
+src/changelog.md
 src/code_of_conduct.md
 src/contributing.md
 

docs/Project.toml

@@ -1,5 +1,6 @@
 [deps]
 CairoMakie = "13f3f980-e62b-5c42-98c6-ff1f3baf88f0"
+Changelog = "5217a498-cd5d-4ec6-b8c2-9b85a09b6e3e"
 Documenter = "e30172f5-a6a5-5a46-863b-614d45cd2de4"
 ForwardDiff = "f6369f11-7733-5829-9624-2563aa707210"
 HOHQMesh = "e4f4c7b8-17cb-445a-93c5-f69190ed6c8c"

docs/make.jl

@@ -1,5 +1,6 @@
 using Documenter
 import Pkg
+using Changelog: Changelog
 
 # Fix for https://github.com/trixi-framework/Trixi.jl/issues/668
 if (get(ENV, "CI", nothing) != "true") && (get(ENV, "TRIXI_DOC_DEFAULT_ENVIRONMENT", nothing) != "true")
@@ -99,6 +100,14 @@ files = [
     ]
 tutorials = create_tutorials(files)
 
+# Create changelog
+Changelog.generate(
+    Changelog.Documenter(),                    # output type
+    joinpath(@__DIR__, "..", "NEWS.md"),       # input file
+    joinpath(@__DIR__, "src", "changelog.md"); # output file
+    repo = "trixi-framework/Trixi.jl",         # default repository for links
+)
+
 # Make documentation
 makedocs(
     # Specify modules for which docstrings should be shown
@@ -152,6 +161,7 @@ makedocs(
                         "Trixi2Vtk.jl" => "reference-trixi2vtk.md"
                        ],
         "Authors" => "authors.md",
+        "Changelog" => "changelog.md",
         "Contributing" => "contributing.md",
         "Code of Conduct" => "code_of_conduct.md",
         "License" => "license.md",