pagure for Debian
=================

Minified JS/CSS
---------------

The package contained a lot of non-free, minified JavaScript and CSS
files; they had to be removed in order to make the package
DFSG-compliant (see d/copyright).  To replace them, I tried to use as
many JavaScript Debian packages as I could.  Some of the dependencies
are not packaged yet, so I chose to remove the minified JS but keep
the non-minified version in the source, and re-generate the minified
JS/CSS "by hand" (after dh_auto_install).

Broken/unsafe links under pagure/hooks/files/
---------------------------------------------

For some reason, under the pagure/hooks/files/ directory, there were
some symbolic links pointing to "/does/not/exist".  I could not find
an explanation for their existence, nor an indication that they were
necessary for anything, so I chose to remove them from the sources as
well (lintian would emit an error otherwise).

TODO
----

There are still lots of things that could be done to improve this
package.  A non-exhaustive list follows:

- Improve debconf integration.  We could ask the user to choose the
  username that will be created, for example.  Surely there's lots to
  do on this front.

- Improve systemd unit files.  If you run lintian with --pedantic, it
  will emit some notices about possible improvements for the unit
  files.

- Work with upstream in order to "liberate" the JavaScript files in
  the package.  Upstream unfortunately ships minified some JS without
  the corresponding source code.  We should be able to *at least* have
  the non-minified source code of every JS.  Ideally, they should all
  be packaged for Debian.  This is one of the reasons the Debian
  pagure package doesn't carry most of the themes available upstream.

- Some of the fonts present in the upstream themes are also not
  packaged for Debian.

 -- Sergio Durigan Junior <sergiodj@debian.org>  Mon, 03 Feb 2020 18:49:20 -0500
