Removed outdated installation instructions.

- macport: stuck on 1.6
- slackware: stuck on 1.6
- OpenBSD: stuck on 1.6

Remove twitter reference. Removed mailing list reference.

Author: semohr

docs/faq.rst

@@ -5,7 +5,6 @@ Here are some answers to frequently-asked questions from IRC and elsewhere.
 Got a question that isn't answered here? Try the `discussion board`_, or
 :ref:`filing an issue <bugs>` in the bug tracker.
 
-.. _mailing list: https://groups.google.com/group/beets-users
 .. _discussion board: https://github.com/beetbox/beets/discussions/
 
 .. contents::
@@ -182,7 +181,7 @@ Please follow these guidelines when reporting an issue:
    readable if you put them in a pastebin (e.g.,
    `Gist <https://gist.github.com/>`__ or
    `Hastebin <https://hastebin.com/>`__), especially when communicating
-   over IRC or email.
+   over IRC.
 -  Turn on beets' debug output (using the -v option: for example,
    ``beet -v import ...``) and include that with your bug report. Look
    through this verbose output for any red flags that might point to the

docs/guides/main.rst

@@ -9,14 +9,34 @@ collection better.
 Installing
 ----------
 
-You will need Python.
-Beets works on Python 3.8 or later.
+Beets requires Python 3.9 or later, you will need to install that first. Depending
+on your operating system, you may also be able to install beets from a package
+manager, or you can install it with `pip`_.
 
-* **macOS** 11 (Big Sur) includes Python 3.8 out of the box.
-  You can opt for a more recent Python installing it via `Homebrew`_
-  (``brew install python3``).
-  There's also a `MacPorts`_ port. Run ``port install beets`` or
-  ``port install beets-full`` to include many third-party plugins.
+Using pip
+^^^^^^^^^
+
+To use the most recent version of beets, we recommend installing it with
+`pip`_, the Python package manager. If you don't have `pip`_ installed, you can
+follow the instructions on the `pip installation page`_ to get it set up.
+
+.. code-block:: console
+
+    pip install beets
+    # or, to install for the current user only:
+    pip install --user beets
+
+
+.. attention:: Python 3.13 not officially supported yet!
+    
+    If you are using Python 3.13, please be aware that it is not yet officially supported yet.
+    You may encounter issues, and we recommend using Python 3.12 or earlier until support is confirmed.
+
+
+Using a Package Manager
+^^^^^^^^^^^^^^^^^^^^^^^
+
+Depending on your operating system, you may be able to install beets using a package manager. Here are some common options:
 
 * On **Debian or Ubuntu**, depending on the version, beets is available as an
   official package (`Debian details`_, `Ubuntu details`_), so try typing:
@@ -39,66 +59,30 @@ Beets works on Python 3.8 or later.
 
 * On **FreeBSD**, there's a `beets port <FreeBSD_>`_ at ``audio/beets``.
 
-* On **OpenBSD**, there's a `beets port <OpenBSD_>`_ can be installed with ``pkg_add beets``.
-
-* For **Slackware**, there's a `SlackBuild`_ available.
-
 * On **Fedora** 22 or later, there's a `DNF package`_ you can install with ``sudo dnf install beets beets-plugins beets-doc``.
 
 * On **Solus**, run ``eopkg install beets``.
 
 * On **NixOS**, there's a `package <NixOS_>`_ you can install with ``nix-env -i beets``.
 
 .. _DNF package: https://packages.fedoraproject.org/pkgs/beets/
-.. _SlackBuild: https://slackbuilds.org/repository/14.2/multimedia/beets/
 .. _FreeBSD: http://portsmon.freebsd.org/portoverview.py?category=audio&portname=beets
 .. _AUR: https://aur.archlinux.org/packages/beets-git/
 .. _Debian details: https://tracker.debian.org/pkg/beets
 .. _Ubuntu details: https://launchpad.net/ubuntu/+source/beets
-.. _OpenBSD: http://openports.se/audio/beets
 .. _Arch extra: https://archlinux.org/packages/extra/any/beets/
 .. _Alpine package: https://pkgs.alpinelinux.org/package/edge/community/x86_64/beets
 .. _NixOS: https://github.com/NixOS/nixpkgs/tree/master/pkgs/tools/audio/beets
-.. _MacPorts: https://www.macports.org
-
-If you have `pip`_, just say ``pip install beets`` (or ``pip install --user
-beets`` if you run into permissions problems).
-
-To install without pip, download beets from `its PyPI page`_ and run ``python
-setup.py install`` in the directory therein.
-
-.. _its PyPI page: https://pypi.org/project/beets/#files
-.. _pip: https://pip.pypa.io
-
-The best way to upgrade beets to a new version is by running ``pip install -U
-beets``. You may want to follow `@b33ts`_ on Twitter to hear about progress on
-new versions.
-
-.. _@b33ts: https://twitter.com/b33ts
-
-Installing by Hand on macOS 10.11 and Higher
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Starting with version 10.11 (El Capitan), macOS has a new security feature
-called `System Integrity Protection`_ (SIP) that prevents you from modifying
-some parts of the system. This means that some ``pip`` commands may fail with a
-permissions error. (You probably *won't* run into this if you've installed
-Python yourself with `Homebrew`_ or otherwise. You can also try `MacPorts`_.)
-
-If this happens, you can install beets for the current user only by typing
-``pip install --user beets``. If you do that, you might want to add
-``~/Library/Python/3.6/bin`` to your ``$PATH``.
-
-.. _System Integrity Protection: https://support.apple.com/en-us/HT204899
-.. _Homebrew: https://brew.sh
+.. _pip: https://pip.pypa.io/en/
+.. _pip installation page: https://pip.pypa.io/en/stable/installation/
 
 Installing on Windows
 ^^^^^^^^^^^^^^^^^^^^^
 
 Installing beets on Windows can be tricky. Following these steps might help you
 get it right:
 
-1. If you don't have it, `install Python`_ (you want at least Python 3.8). The
+1. If you don't have it, `install Python`_ (you want at least Python 3.9). The
    installer should give you the option to "add Python to PATH." Check this
    box. If you do that, you can skip the next step.
 
@@ -109,7 +93,7 @@ get it right:
    should open the "System Properties" screen, then select the "Advanced" tab, 
    then hit the "Environmental Variables..." button, and then look for the PATH 
    variable in the table. Add the following to the end of the variable's value: 
-   ``;C:\Python38;C:\Python38\Scripts``. You may need to adjust these paths to 
+   ``;C:\Python39;C:\Python39\Scripts``. You may need to adjust these paths to 
    point to your Python installation.
 
 3. Now install beets by running: ``pip install beets``
@@ -123,9 +107,8 @@ sure the paths to Python match your system. Then double-click the file add the
 necessary keys to your registry. You can then right-click a directory and
 choose "Import with beets".
 
-Because I don't use Windows myself, I may have missed something. If you have
-trouble or you have more detail to contribute here, please direct it to
-`the mailing list`_.
+If you have trouble or you have more detail to contribute here, please direct it to
+`the discussion board`_.
 
 .. _install Python: https://python.org/download/
 .. _beets.reg: https://github.com/beetbox/beets/blob/master/extra/beets.reg
@@ -326,6 +309,5 @@ beets blog <https://beets.io/blog/walkthrough.html>`_.
 Please let us know what you think of beets via `the discussion board`_ or
 `Mastodon`_.
 
-.. _the mailing list: https://groups.google.com/group/beets-users
 .. _the discussion board: https://github.com/beetbox/beets/discussions
 .. _mastodon: https://fosstodon.org/@beets

docs/guides/tagger.rst

@@ -309,5 +309,4 @@ I Hope That Makes Sense
 If we haven't made the process clear, please post on `the discussion
 board`_ and we'll try to improve this guide.
 
-.. _the mailing list: https://groups.google.com/group/beets-users
 .. _the discussion board: https://github.com/beetbox/beets/discussions/