Skip to content

Restructure repository, to move all source code into /src folder #6837

@jmckenna

Description

@jmckenna

Reasoning

  • for the user, it is much easier to understand a repository when the general files (READMEs, markdown files, CMakelists.txt, .yaml files) only exist in the root directory, and the source files (.c, .h, cpp, etc) live in /src
  • this is the common structure now, in FOSS4G projects (such as the QGIS repo)
  • it is so much easier to come to a new repository for the first time, and understand it, as the important markdown files are easily found

Proposed layout

MapServer/
      .github/
      ci/
      cmake/
      etc/
      fonts/
      fuzzers/
      msautotest/
      scripts/
      share/
      src/
          apache/
          flatgeobuf/
          mapscript/
          opengl/
          renderers/
          third-party/
          *.c
          *.cpp
          *.h
      symbols/
      tests/
      xmlmapfile/
      .travis.yml
      appveyor.yml
      CMakeLists.txt
      CONTRIBUTING.md
      HISTORY.md
      LICENSE.md
      README.md
      SECURITY.md

Timing

I would love to do this for the imminent 8.0.1 release, but this is a major impact to packagers, so instead I propose to tackle this for 8.2.0 instead. (likely also include #6593 )

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions