Bug 260199 - FAQ references to NVIDIA resources
Summary: FAQ references to NVIDIA resources
Status: Closed Not A Bug
Alias: None
Product: Documentation
Classification: Unclassified
Component: Books & Articles (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Many People
Assignee: Sergio Carlavilla Delgado
URL: https://cgit.freebsd.org/doc/tree/doc...
Keywords:
Depends on:
Blocks: 260183
  Show dependency treegraph
 
Reported: 2021-12-04 05:46 UTC by Graham Perrin
Modified: 2023-02-17 19:14 UTC (History)
3 users (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Graham Perrin freebsd_committer freebsd_triage 2021-12-04 05:46:12 UTC
Under <https://docs.freebsd.org/en/books/faq/#x-3d-acceleration>: 

> … nVidia provides detailed information on which card is supported by which 
> driver on their web site: http://www.nvidia.com/object/IO_32667.html. …

From bug 260183 comment 0: 

> … _not_ the best page to tell which driver is appropriate because the 
> result is legacy-only <https://www.nvidia.com/en-us/drivers/unix/legacy-gpu/>.


Instead, maybe: 

<https://www.nvidia.com/en-gb/drivers/unix/>

> Unix Drivers | NVIDIA


Not anchorable, but there are sections for: 

* FreeBSD x86

* FreeBSD x64

The latter includes a link to the latest production branch, where (through clicking the version) a SUPPORTED PRODUCTS tab makes things reasonably clear for this branch. 


Legacy
======

<https://forums.freebsd.org/posts/524748> reminds me that <https://www.nvidia.com/en-us/drivers/unix/legacy-gpu/> – 

> What's a legacy driver? | NVIDIA

– was somewhat ambiguous, possibly contradictory, when read alongside other NVIDIA resources. Still, this NVIDIA page is probably a useful point of reference. 


Edge cases
==========

<https://lists.freebsd.org/archives/freebsd-hackers/2021-December/000582.html> for example, Andriy Gapon wrote: 

> Apparently not all GT 730 cards are made equal. …

Without attempting to detail any case, maybe the FAQ (or better the Handbook) should simply: 

* acknowledge that edge cases exist

    "NVIDIA's pages are not entirely authoritiative"
    or words to that effect

* steer to <https://www.freebsd.org/support/> in case of trouble.
Comment 1 Graham Perrin freebsd_committer freebsd_triage 2021-12-04 06:03:17 UTC
(In reply to Graham Perrin from comment #0)

> … a SUPPORTED PRODUCTS tab makes things reasonably clear …

It should be pointed out that the adjacent DOWNLOAD button is not appropriate if, as is likely, the reader intends to use the FreeBSD-maintained port. 

----

Side note (not for the FAQ): <https://forums.freebsd.org/posts/545002> mentions NVIDIA's installer making inappropriate changes to /boot/loader.conf
Comment 2 Graham Perrin freebsd_committer freebsd_triage 2022-12-30 11:59:37 UTC
Triage, batch edit (just one): 

* for twenty-eight FreeBSD Handbook-related reports that had gained a 
  personal assignee, prior group/list assignee doc@ was 
  missing from the CC list.

Gentle hint: <https://wiki.freebsd.org/Bugzilla/> ▶ do, don't …
Comment 3 Sergio Carlavilla Delgado freebsd_committer freebsd_triage 2023-02-17 19:14:31 UTC
Since the FAQ is gonna be rewritten, we can close this