Hi Thomas,
Thomas Lange wrote:
> Since the FAI guide is not updated to 4.x it's important to inform the
> user about important changes, which I did with this NEWS
> entries. Maybe some of them are not that important, but it's a good
> list to check when upgrading from FAI 3.x to 4.x.
>
> Do you have any suggestions how to improve the NEWS entry?
Thanks for asking. Yes, I do.
I would suggest some text that (1) is less overwhelming and (2) makes
it crystal clear to sysadmins what immediate action on their part is
required. For example:
fai (4.0) unstable; urgency=low
This is a major update of FAI which brings important changes,
and the FAI guide has not been updated to reflect them yet.
Changes include:
- new script names
- new configuration file names
- some tasks were renamed or reorganized
- new features that may affect you because <explanation
of why multicore support, huge speedup, etc require
immediate action goes here>
- new log files
Your scripts and configuration may need changes to work
with the new version. See /usr/share/doc/fai/changelog.Debian.gz
for details.
-- Thomas Lange <la...@debian.org> <date>
Does that help?
Thanks,
Jonathan
--
To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org
