git: 9f50d43db4 - main - Status/2024Q1: Add freshports.adoc

The branch main has been updated by salvadore:

URL: https://cgit.FreeBSD.org/doc/commit/?id=9f50d43db4db48002648de4197b85451d67bca1f

commit 9f50d43db4db48002648de4197b85451d67bca1f
Author:     Dan Langille <dvl@FreeBSD.org>
AuthorDate: 2024-03-20 08:34:23 +0000
Commit:     Lorenzo Salvadore <salvadore@FreeBSD.org>
CommitDate: 2024-03-20 08:34:43 +0000

    Status/2024Q1: Add freshports.adoc
    
    Reviewed by:    status (Pau Amma <pauamma@gundo.com>),
                    Graham Perrin <grahamperrin@gmail.com>
    Pull Request:   https://github.com/freebsd/freebsd-doc/pull/345
---
 .../status/report-2024-01-2024-03/freshports.adoc  | 50 ++++++++++++++++++++++
 1 file changed, 50 insertions(+)

diff --git a/website/content/en/status/report-2024-01-2024-03/freshports.adoc b/website/content/en/status/report-2024-01-2024-03/freshports.adoc
new file mode 100644
index 0000000000..fe8b3a7829
--- /dev/null
+++ b/website/content/en/status/report-2024-01-2024-03/freshports.adoc
@@ -0,0 +1,50 @@
+=== FreshPorts: Notification of new packages
+
+Links: +
+link:https://freshports.org/[FreshPorts] URL: link:https://freshports.org/[] +
+link:https://news.freshports.org/[FreshPorts blog] URL: link:https://news.freshports.org/[]
+
+Contact: Dan Langille <dvl@FreeBSD.org>
+
+FreshPorts and FreshSource have reported upon FreeBSD commits for 20 years.
+They cover all commits, not just ports.
+
+FreshPorts tracks the commits and extracts data from the port Makefiles to create a database of information useful to both port maintainers and port users.
+
+For example, link:https://www.freshports.org/security/acme.sh/#packages[] shows the history of the package:security/acme.sh[] port, back to its creation in May 2017.
+Also available are dependencies, flavors, configuration options, and available packages.
+All of this is useful for both users and developers of ports.
+
+==== Notification: New Package Available
+
+One of the original features of FreshPorts is notification of ports updates.
+You can create a list of ports and receive notifications about those ports.
+This new feature can also notify when a new package is available for that port.
+The use case: a known security vuln has been patched.
+FreshPorts will tell you the port has been patched, and then you wait for the package.
+This new feature will tell you when that package is available.
+
+Details at:
+
+* link:https://github.com/FreshPorts/freshports/issues/542[]
+
+==== Help Needed
+
+It has been over 22 years since FreshPorts started.
+Others must take over eventually.
+I have started that process recently.
+There are several aspects to FreshPorts:
+
+* FreeBSD admin (updating the OS and packages)
+* front end code (website - mostly PHP)
+* back end code (commit processing - Perl, Python, shell)
+* database design (PostgreSQL).
+
+The database does not change very often and requires little maintenance compared to the applications and OS.
+The website pretty much runs itself.
+From time to time, a change to the FreeBSD ports infrastructure breaks something or requires a modification, but there is rarely any urgency to fix that.
+This is not a huge time commitment.
+There is a lot of learning.
+While not a complex application, FreshPorts is also not trivial.
+
+To contribute, please join the link:https://lists.freshports.org/mailman/listinfo/freshports-coders[] mailing list and let us know what you would like to help with.
\ No newline at end of file