Skip to content

Latest commit

 

History

History
169 lines (120 loc) · 9.71 KB

File metadata and controls

169 lines (120 loc) · 9.71 KB

🌐 QGIS Changelog website DPG Badge

image

👋 Welcome to the QGIS Changelog Website!

This repository hosts the source code for the website that creates 'visual changelogs' for QGIS releases:

🌍 https://changelog.qgis.org

Here you'll find everything you need to build, develop, and contribute to this site.

⚠️ Note on Other QGIS Websites

This repository is only for the QGIS Changelog Website (changelog.qgis.org).

If you are looking for the source code or want to contribute to other QGIS websites, please visit their respective repositories below. Each website has its own codebase and contribution process:

-----------------------------------------------------

📖 Table of Contents

Table of Contents
  1. 🚀 Project Overview
  2. 🚥 QA Status
  3. 📜 License
  4. 📂 Folder Structure
  5. 🤖 Using 'AI' (Large Language Models)
  6. 🗄️ Data Model
  7. 🧊 Using the Nix Shell
  8. ✨ Contributing
  9. 🙋 Have Questions?
  10. 🧑‍💻👩‍💻 Contributors
  11. 🙏 Credits

-----------------------------------------------------

🚀 Project Overview

Overview

-----------------------------------------------------

🚥 QA Status

🪪 Badges

Badge Description
Lint and Django Unit Tests Lint and Django Unit Tests
Build and Push Docker Image to DockerHub Build and Push Docker Image to DockerHub
Website Status Website availability status
License Repository license
Open issues count
Closed issues count
Open pull requests count
Closed pull requests count

⭐️ Project Stars

Stars

-----------------------------------------------------

📜 License

This project is licensed under the GPLv3 License. See the COPYING file for details.

-----------------------------------------------------

📂 Folder Structure

QGIS-Changelog-Website/
├── 📦 deployment/                  # Deployment scripts and configuration
├── 🛰️ django_project/              # Main Django application source code
├── 🖼️ img/                         # Images and media assets for this README
├── 🧪 codecov.yml                  # Codecov configuration for test coverage
├── 📜 COPYING                      # Project license file (GPL-2.0)
├── 📝 list-vscode-extensions.sh*   # List recommended VSCode extensions for Nix shell
├── 👥 MAINTAINERS                  # Maintainers list
├── 📖 README.md                    # Project overview and documentation (this file)
├── 📦 REQUIREMENTS-dev.txt         # Python dependencies for development
├── 📦 REQUIREMENTS.txt             # Python dependencies for production
├── 🧊 shell.nix                    # Nix shell environment definition
└── 🖥️ vscode.sh*                   # VSCode helper script for Nix shell

-----------------------------------------------------

🤖 Using 'AI' (Large Language Models)

We are fine with using LLM's and Generative Machine Learning to act as general assistants, but the following three guidelines should be followed:

  1. Repeatability: Although we understand that repeatability is not possible generally, whenever you are verbatim using LLM or Generative Machine Learning outputs in this project, you must also provide the prompt that you used to generate the resource.
  2. Declaration: Sharing the prompt above is implicit declaration that a machine learning assistant was used. If it is not obvious that a piece of work was generated, include the robot (🤖) icon next to a code snippet or text snippet.
  3. Validation: Outputs generated by a virtual assistant should always be validated by a human and you, as contributor, take ultimate responsibility for the correct functionality of any code and the correct expression in any text or media you submit to this project.

-----------------------------------------------------

🗄️ Data Model

TODO: Refactor the models and remove unused app (ex: djstripe)

-----------------------------------------------------

🧊 Using the Nix Shell

Please refer to the Nix section in CONTRIBUTING.md.

-----------------------------------------------------

✨ Contributing

We welcome contributions! Please read the CONTRIBUTING.md for guidelines on how to get started.

-----------------------------------------------------

🙋 Have Questions?

Have questions or feedback? Feel free to open an issue or submit a Pull Request!

-----------------------------------------------------

🧑‍💻👩‍💻 Contributors

Thank you to the individual contributors who have helped to build the QGIS Changelog:

-----------------------------------------------------

🙏 Credits

The original project called Projecta was funded and developed by Kartoza.com and individual contributors.

-----------------------------------------------------

Made with ❤️ by Tim Sutton (@timlinux), Lova Andriarimalala (@Xpirix) and QGIS Contributors.