2025 final (#16)

* added uv

* added tools.md from conference reop (https://github.com/PioneersHub/conference/blob/main/docs/guidelines/tools.md) thanks to dringler
other small updates

Author: alanderex

.pre-commit-config.yaml

@@ -6,6 +6,15 @@ repos:
       - id: end-of-file-fixer
       - id: trailing-whitespace
       - id: check-toml
+  - repo: https://github.com/astral-sh/uv-pre-commit
+    # uv version.
+    rev: 0.6.8
+    hooks:
+      - id: uv-lock
+      - id: uv-export
+      - id: pip-compile
+        args: [requirements-dev.in, -o, requirements-dev.txt]
+        files: ^requirements-dev\.(in|txt)$
   - repo: https://github.com/quantco/pre-commit-mirrors-ruff
     rev: 0.4.3
     hooks:

config.yml

@@ -147,5 +147,5 @@ social_cards:
     # relative paths from the repository root
     cache_dir: "./.cache/plugin/social"
     site_dir: "./site/assets/images/social"
-    # convention, rename your logo accordingly
+    # by convention, rename your logo accordingly
   logo_path: "./docs/assets/images/social_card_logo.png"

docs/guidelines/communication.md

@@ -6,3 +6,15 @@ icon: fontawesome/solid/bullhorn
 
 !!! warning
     This document is a work in progress. Please check back later for updates.
+
+
+What and when to communicate
+
+- Blog Posts
+- review any other parts of the website that might require updates
+- website sections we use to point attendees to what currently matters
+- communication plan and who to involve
+
+Als Social Card verwenden wir welche mit passender Beschriftung. 
+Falls keine individuelle Social Card vorhanden ist,  den Link im Header entfernen. Dann wird die Social Card der Webseite automatisch verwendet.
+

docs/guidelines/swag.md

@@ -4,11 +4,6 @@ icon: fontawesome/solid/shirt
 ---
 # Swag 
 
-!!! warning
-    This document is a work in progress. Please check back later for updates.
-
----
-
 ## Swag Guidelines
 
 We do not produce any swag except for the pre-order conference t-shirts.

docs/guidelines/tools.md

@@ -0,0 +1,30 @@
+---
+title: Toolzoo
+icon: fontawesome/solid/hippo
+---
+# Tools Guidelines
+Tools and intersections used in open source community events.
+
+1. [GitHub](https://github.com/)
+    - public documentation: https://github.com/PioneersHub/conference and https://pioneershub.github.io/pyconde25-conference/
+    - website
+2. [Tito](https://ti.to) for ticketing
+3. [pretalx](https://pretalx.com) for CfP (Call for Proposals)
+    - collect & review proposals and create schedule
+4. [Pytanis](https://github.com/PioneersHub/pytanis) as interface to pretalx
+5. Validation Service: REST API for participant info (TODO: add link)
+    - validate conference participants via ticket ID and name
+    - validate if email address is a participant
+6. [Discord](https://discord.com/) as conference communication platform
+7. Discord Bot: https://github.com/PYCONDE/discord/tree/main
+    - registration service: user authentification via ticket ID and name using the Validation Service. Adds the required discord roles to the user
+    - program notifications: send notifications to the program in the discord channel
+    - job board: send job offers from the sponsors automatically to the job board (currently works with csv file import and should be updated to read from google forms directly)
+8. [pytube](https://github.com/PioneersHub/pytube) for YouTube video publishing
+9. [Certificate of attendance](https://github.com/PioneersHub/participation_certificate) for PDF document creation
+10. [Team page helper app](https://github.com/PioneersHub/team_page_helper_app) for adding team members to the website
+    - creates json and makes a PR on the conference website
+
+# External Tools and Services
+
+1. Mailgun for transactional emails.

mkdocs.yml

@@ -35,6 +35,8 @@ nav:
       - Diversity:
           - Grant-Applications: guidelines/grant-applications.md
           - Grants-Guidelines: guidelines/grants.md
+      - Toolgarden:
+          - Tools: guidelines/tools.md
       - Governance:
           - Governance: guidelines/governance.md
       - Infrastructure:

pyproject.toml

@@ -1,5 +1,5 @@
 [project]
-name = "PyCon DE & PyData 2025"
+name = "pyconde-pydata-2025-conference"
 version = "0.3.4"
 description = "Public documentation for organizing our volunteer-driven conference."
 authors = [
@@ -12,6 +12,19 @@ classifiers = [
     "Programming Language :: Python :: 3.12",
 ]
 
+dependencies = [
+    "bumpversion>=0.6.0",
+    "mkdocs>=1.6.1",
+    "mkdocs-glightbox>=0.4.0",
+    "mkdocs-macros-plugin>=1.3.7",
+    "mkdocs-material[imaging]>=9.6.9",
+    "mkdocs-open-in-new-tab>=1.0.8",
+    "omegaconf>=2.3.0",
+    "pymdown-extensions>=10.14.3",
+    "pytanis>=0.8",
+    "webcolors>=24.11.1",
+]
+
 [build-system]
 requires = ["setuptools"]
 build-backend = "setuptools.build_meta"
@@ -46,4 +59,4 @@ ignore = [
 [tool.ruff.format]
 quote-style = "double"
 indent-style = "space"
-docstring-code-format = true
+docstring-code-format = true