openstreetmap / openstreetmap/mod_tile

Current sample config files has diverged from documentation

Open
#310 2 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
C++
Stars
318
Forks
199
PR merge metrics
No merged PRs in 30d

Description

While writing compile docs for Debian 12, I had to change many things from the old Ubuntu 20.04 instructions, because the sample config are differed. Even the github actions for this project do a hack to fix the mapnik path. For details on changes, see the commits on this PR

I'm unsure the solution. Dropping support for Ubuntu 20.04 in the sample configs might work.

I haven't looked at the CentOS or Red Hat documentaiton. They might have the same issue(s).

See also: https://github.com/openstreetmap/mod_tile/pull/309 https://github.com/openstreetmap/mod_tile/issues/295

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the commits on pull request 309 and the Ubuntu 20.04 and Debian 12 instructions referenced in the issue. Inspect .github/actions/apache/configure/action.yml around the Mapnik path workaround, then compare the sample config files with the documented platform instructions. Done means the sample configurations and documentation agree across the covered distributions, with the CentOS and Red Hat status resolved.

Written by the indexing model from the issue text.

Assessment

Tech stack
apache, cpp, github-actions
Domain
devops, documentation
Issue type
Documentation
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.