Bug 265227 - Aim for consistent information about mirroring, consider rationalising some of the various README.TXT files
Summary: Aim for consistent information about mirroring, consider rationalising some o...
Status: Open
Alias: None
Product: Documentation
Classification: Unclassified
Component: Books & Articles (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Some People
Assignee: Sergio Carlavilla Delgado
URL: https://docs.freebsd.org/en/articles/...
Keywords: needs-patch
Depends on:
Blocks:
 
Reported: 2022-07-15 06:35 UTC by Graham Perrin
Modified: 2023-08-26 07:15 UTC (History)
3 users (show)

See Also:

Attachments
Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.
Comment 1 Graham Perrin freebsd_committer freebsd_triage 2022-07-15 07:02:06 UTC 
Some extracts …

----

> not accepting new mirrors 

> looking for new locations; 

> not looking for additional mirrors.

----

> ports/${ARCH}/
>     The FreeBSD package collection for supported architectures of the
>     FreeBSD 8.4-RELEASE.  

– outdated

> ports/distfiles/
>     Relocated to: http://distcache.FreeBSD.org/ports-distfiles/
> ports/local-distfiles/
>     Relocated to: http://distcache.FreeBSD.org/local-distfiles/

– I can guess why both URLs are 403 forbidden, an explanation (forewarning) will be smart. 

----

<https://download.freebsd.org/releases/README.TXT>

> … target architecture:
> 
> 	amd64/amd64			Intel/AMD x86_64 (64-bit)
> 	i386/i386			Intel/AMD x86 (32-bit)
> 	ia64/ia64			Intel Itanium
> 	powerpc/powerpc			32-bit PowerPC
> 	powerpc/powerpc64		64-bit PowerPC
> 	sparc64/sparc64			Sparc64

– is aarch64 missing from this table? Compare with e.g. 
  <https://www.freebsd.org/platforms/>


> http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/mirrors.html#MIRRORS-CDROM

– redirects to <https://docs.freebsd.org/en/books/handbook/mirrors/#MIRRORS-CDROM>, a non-existent anchor.
Comment 2 Graham Perrin freebsd_committer freebsd_triage 2022-07-15 07:11:18 UTC 
Early thoughts: 

1. (a) <https://docs.freebsd.org/en/books/handbook/mirrors/#mirrors> 
       should include a link out to 
   (b) <https://docs.freebsd.org/en/articles/hubs/>

2. (a) and (b) should be reasonably up-to-date, and attractive from 
   maintenance perspectives, with minimal or zero overlap between the two

3. move, or delete, as much as possible from README files (be 
   realistic about long term maintenance)

   * if the gist of some things can be _meaningfully_ 
     moved to (a) or (b), do so, but avoid making things so verbose 
     that readers (including maintainers of docs) will switch off from 
     content.
Comment 3 Fernando Apesteguía freebsd_committer freebsd_triage 2022-10-09 16:04:44 UTC 
^Triage: reporter is committer, assign accordingly.