Dear Luke and other people,
As a way of debuting our new mailing list and getting job done, I would like
to use this as a medium to refine things that should be in the release notes
for the 1.5 release.
Here is a draft that I've come up with so far. Please, add new comments so
that we can get this polished and 1.5 out of the door, so that we can start
working on 1.6.
Once we have the content done, formatting it should be easy to get in
various media (including the wordpress homepage).
I have tried to keep this is an markdown format, to be able to use automated
generation of the documentation.
-----
# Introduction
We are proud to announce a new version of TunesViewer, a simple,
easy-to-use, open-source, application for Unix-like systems meant to access
the iTunes U (the educational material) present in Apple's iTunes Store.
The 1.5 release has seen improvements in many fronts, most of which are in
adaptation of the code for changes in Apple's iTunes Store, in better code,
and some in improvements in the project administration.
# User-visible changes
* Easier production of up-to-date packages for Debian-derived distributions
(which include Ubuntu and Linux Mint, for example).
* New possibility of specifying folders where the downloads should be
placed.
* New, more attractive icon for TunesViewer.
* TunesViewer now stores its configuration in XDG compliant locations, which
should make it easier to backup your data.
* Some new command-line options can be seen with the invocation of
`tunesviewer --help`. Expect more options to be available.
* Other minor (but important) usability changes in the user interface.
# Improvements in the project administration
* For development-related discussion and planning, we have
created a mailing list at <mailto:tun...@li...>.
* Support requests can be much faster to be acted upon if they
are *not* sent to individual developers, but to a place where
it is visible to all developers. The preferred place for
reporting problems, and asking for feature requests is at
<https://github.com/rbrito/tunesviewer/issues>.
While reporting a bug or filing a feature request, please
inform us the version of TunesViewer that you are using, the
operating system (if it is Linux, which distribution) and any
other information that you think that may be appropriate.
We encorage you to be as verbose and descriptive as possible,
so that we can better understand what the issues are.
* New location of development versions of TunesViewer from SourceForge to
GitHub: <https://github.com/rbrito/tunesviewer>.
# Under the hood
The source code of TunesViewer has seen a lot of changes since the release
of version 1.4. The code has seen more than 250 commits from 3
contributors, with almost 60 files changed, more than over 6000 lines of
code added and more than 3400 lines of code removed.
Among the many changes, some highlights are:
* Extensive revision of the Debian packaging has been made, so that newer
releases can be done in a faster and more automated way.
* Creation of some unit-tests (with more to come).
* More modular code-base, easing maintainability and code reuse.
* Removal of some dead-code spots.
* Adaptations to changes in Apple's iTunes Store.
* Change of license of the project from Apache 2.0 to the GPL version 2 or
later.
-----
Well, Any comments on "the press-release above" would be more than welcome.
Regards,
--
Rogério Brito : rbrito@{ime.usp.br,gmail.com} : GPG key 4096R/BCFCAAAA
http://rb.doesntexist.org/blog : Projects : https://github.com/rbrito/
DebianQA: http://qa.debian.org/developer.php?login=rbrito%40ime.usp.br
|