Bug 290967 - Link packages to freshports rather than cgit
Summary: Link packages to freshports rather than cgit
Status: Open
Alias: None
Product: Documentation
Classification: Unclassified
Component: Books & Articles (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Many People
Assignee: freebsd-doc (Nobody)
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2025-11-12 07:00 UTC by Paavo-Einari Kaipila
Modified: 2025-11-15 11:34 UTC (History)
2 users (show)

See Also:


Attachments
0001-Link-packages-to-freshports-rather-than-cgit.patch (822 bytes, patch)
2025-11-12 07:03 UTC, Paavo-Einari Kaipila
no flags Details | Diff

Note You need to log in before you can comment on or make changes to this bug.
Description Paavo-Einari Kaipila 2025-11-12 07:00:07 UTC
Often requested feature
Comment 1 Paavo-Einari Kaipila 2025-11-12 07:03:06 UTC
Created attachment 265353 [details]
0001-Link-packages-to-freshports-rather-than-cgit.patch
Comment 2 Michael Osipov freebsd_committer freebsd_triage 2025-11-12 13:24:43 UTC
(In reply to Paavo-Einari Kaipila from comment #1)

This is a problem. I often get "Server too busy. Please try again later. You should never see this message if you are logged in.". I wouldn't link to such a target.
Comment 3 Paavo-Einari Kaipila 2025-11-12 15:41:33 UTC
(In reply to Michael Osipov from comment #2)

You don't need an internet connection to find the same information as in cgit, because you have the ports tree in your coputer.

Users who this is for, do not and cgit provides absolutely no useful information for them anyway.
Comment 4 Graham Perrin freebsd_committer freebsd_triage 2025-11-12 16:59:11 UTC
+100 from me. 

This is effectively a duplicate of 2022 bug 267798, which was closed (works as intended), however it's not appropriate for me to close this new report. 

267798 also mentioned <https://www.freebsd.org/ports/> (website, not documentation), which was later removed. In the Wayback Machine: 

<https://web.archive.org/web/20230915210803/https://www.freebsd.org/ports/>
Comment 5 Paavo-Einari Kaipila 2025-11-12 17:45:48 UTC
(In reply to Graham Perrin from comment #4)

It was closed due to gatekeeping and without an actual reason anyway. Official portal mentioned in that closing message does not exist.
Comment 6 Alexander Ziaee freebsd_committer freebsd_triage 2025-11-12 20:38:50 UTC
>> This is effectively a duplicate of 2022 bug 267798, which was closed (works as intended)

> It was closed due to gatekeeping and without an actual reason anyway. Official portal mentioned in that closing message does not exist.

(bugs maintainer hat on)

The reason given there was that the project has a system, and freshports is an external system. That's a reason you don't like, it's not gatekeeping. I am closing this as a duplicate of that but because it is an exact duplicate.

(bug maintainer hat off)

I prefer our current system because it's a fast, available system that lowers the gap between users and developers.

*** This bug has been marked as a duplicate of bug 267798 ***
Comment 7 Paavo-Einari Kaipila 2025-11-12 21:39:15 UTC
(In reply to Alexander Ziaee from comment #6)

How about having a conversation and not just closing the ticket, because Graham posted a link to your, well...comment towards the person who opened the previous one?

> available system that lowers the gap between users and developers.

People who use cgit do not need links for that. Handbook is advertised as a place for people to start their FreeBSD journey. Makefiles might provide some useful information for you, me and everyone who happens to see this thread. For most people however, they are gibberish. And as I said in the previous message, that portal used as an argument does not exist.
Comment 8 Alexander Ziaee freebsd_committer freebsd_triage 2025-11-12 22:36:34 UTC
> Makefiles might provide some useful information for you, me and everyone who happens to see this thread. For most people however, they are gibberish.

"Makefiles were text files, not magically encoded binaries, because that was the unix ethos; printable, debuggable, understandable stuff" ~Stuart Feldman
Comment 9 Paavo-Einari Kaipila 2025-11-13 00:53:44 UTC
50/50 so far.

You only closed this because Graham posted a link which you weren't very proud of. This topic deserves a conversation or alternatively, the same faith as most doc tickets and to just stay open forever.
Comment 10 Graham Perrin 2025-11-15 11:34:56 UTC
Let's make things professional, not personal. 

Two FreeBSD Foundation examples. 


An archaic example (2018): the FreeBSD Quickstart Guide <https://freebsdfoundation.org/wp-content/uploads/2018/11/quickstartguidefinal.pdf> referred to a page that was first published in June 2017. Its current address: 

<https://freebsdfoundation.org/freebsd-project/resourcesold/installing-a-port-on-freebsd/>

– that's somewhat outdated (it pictures, and describes, 
  <https://www.freebsd.org/ports/>, which no longer exists; 
  and so on). 


A more modern example (2023): the recap of the second Enterprise Working Group Meeting, which used FreshPorts links (not cgit) for projects. <https://freebsdfoundation.org/blog/recap-of-second-enterprise-working-group-meeting/>.