[Bug 260199] FAQ references to NVIDIA resources

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=260199

            Bug ID: 260199
           Summary: FAQ references to NVIDIA resources
           Product: Documentation
           Version: Latest
          Hardware: Any
               URL: https://cgit.freebsd.org/doc/tree/documentation/conten
                    t/en/books/faq/_index.adoc?id=989d921f5d4ac8d8b7c831c1
                    3b8954ad1901be24#n1902
                OS: Any
            Status: New
          Severity: Affects Many People
          Priority: ---
         Component: Documentation
          Assignee: doc@FreeBSD.org
          Reporter: grahamperrin@gmail.com
                CC: avg@FreeBSD.org

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.

-- 
You are receiving this mail because:
You are the assignee for the bug.