Hi,
for testing I tried to install spamassassin 4.0.1 on EL9 (AlmaLinux
9.4). I have noticed some dependencies are not mentioned on the INSTALL
page:
I have had to install perl-ExtUtils-MakeMaker.noarch to run Makefile.PL
I have had to install perl-Archive-Tar.noarch to run sa-update.
Those two are nowhere mentioned.
It also took me a while to find the instructions how to install.
I started at https://spamassassin.apache.org/index.html
where "Click here to get started using SpamAssassin! " looked promising.
But at
https://cwiki.apache.org/confluence/display/SPAMASSASSIN/StartUsing
I have spent considerable time to look for where to download and how to
actually install spamassassin, but eventually gave up. Only now I have
found some instructions on the SingleUserUnixInstall page.
So I have circled back and checked the Download link from the top. There
I can download the tar, get hints on Upgrading but still nothing on
installation.
The Wiki and FAQ links from the top are not helpful either.
So eventually, I have found it on "Docs", pointing to the INSTALL file.
From experience, that it not really the first place I would look.
I would think the "Get Started" page should have a link to the Download
and INSTALL page at the beginning. Downloading and installing seem to be
the obvious first steps to get started.
The Download page should have a link for INSTALL like it already has for
the Upgrade.
And I would say "Where to download" and "How to install" are pretty
common FAQs, too.
I hope this helps.
Thanks,
Gerald