[Python-apps-team] Bug#343675: Documentation issue

[W. Martin Borgert]

retitle 343675 Document deploy and upgrade process
severity 343675 normal
tags 343675 - wontfix + help
tags 562963 + help
thanks

There are some implications of using (or not using) the
commands "trac-admin deploy" and "trac-admin upgrade",
that must be documented in README.Debian. E.g.

- After a "trac-admin /path/to/env deploy", certain
   files are just copied into the Trac environment. If
   the original files are changed (upgrade of Trac or
   jQuery package), the copies remain unchanged.

- After upgrading the Trac package or jQuery (if used),
   all environments must be upgraded using
   "trac-admin /path/to/env upgrade" for every single
   environment.

Unfortunately, it is very difficult to do any of the
steps automatically and very likely to do it wrong. So
it's better to just document the necessary steps.