distro: prepare module for autils migration

- Add module docstring and enhance RST docstrings for all public
  classes and methods (pylint-compliant)
- Add deprecation warning for autils migration
- Remove from .pylintrc_utils ignore list to enable pylint checking
- Add to autils_migration_announcement workflow

Assisted-By: Cursor-Claude-4-Sonnet
Signed-off-by: Harvey Lynden <hlynden@redhat.com>

Author: harvey0100

.github/workflows/autils_migration_announcement.yml

@@ -9,6 +9,7 @@ on:
       - '**/astring.py'
       - '**/crypto.py'
       - '**/data_structures.py'
+      - '**/distro.py'
       - '**/external/gdbmi_parser.py'
       - '**/external/spark.py'
       - '**/gdb.py'

.pylintrc_utils

@@ -7,7 +7,7 @@ extension-pkg-whitelist=netifaces
 
 # Add files or directories to the blacklist. They should be base names, not
 # paths.
-ignore=CVS,archive.py,asset.py,astring.py,aurl.py,build.py,cloudinit.py,cpu.py,data_factory.py,datadrainer.py,debug.py,diff_validator.py,disk.py,distro.py,dmesg.py,download.py,exit_codes.py,file_utils.py,filelock.py,git.py,iso9660.py,kernel.py,linux.py,linux_modules.py,lv_utils.py,memory.py,multipath.py,nvme.py,partition.py,pci.py,pmem.py,podman.py,service.py,softwareraid.py,ssh.py,stacktrace.py,sysinfo.py,vmimage.py,wait.py,gdbmi_parser.py,spark.py,distro_packages.py,inspector.py,main.py,manager.py,apt.py,base.py,dnf.py,dpkg.py,rpm.py,yum.py,zypper.py,deprecation.py
+ignore=CVS,archive.py,asset.py,astring.py,aurl.py,build.py,cloudinit.py,cpu.py,data_factory.py,datadrainer.py,debug.py,diff_validator.py,disk.py,dmesg.py,download.py,exit_codes.py,file_utils.py,filelock.py,git.py,iso9660.py,kernel.py,linux.py,linux_modules.py,lv_utils.py,memory.py,multipath.py,nvme.py,partition.py,pci.py,pmem.py,podman.py,service.py,softwareraid.py,ssh.py,stacktrace.py,sysinfo.py,vmimage.py,wait.py,gdbmi_parser.py,spark.py,distro_packages.py,inspector.py,main.py,manager.py,apt.py,base.py,dnf.py,dpkg.py,rpm.py,yum.py,zypper.py,deprecation.py
 # regex matches against base names, not paths.
 ignore-patterns=.git