=================
Migration Guides
=================

**Audience**: Users upgrading from previous versions of ActingWeb.

This section provides guides for migrating between ActingWeb versions and avoiding common pitfalls.

Contents
========

.. toctree::
   :maxdepth: 2

   v3.10
   v3.7
   v3.1
   common-pitfalls

Version Migrations
==================

**v3.10 Migration**
   Guide for upgrading to ActingWeb 3.10, covering automatic subscription processing with CallbackProcessor, RemotePeerStore, FanOutManager, and peer capabilities.

**v3.7 Migration**
   Guide for upgrading to ActingWeb 3.7, covering developer API extensions for SubscriptionManager and TrustManager with cleaner APIs and automatic lifecycle hooks.

**v3.1 Migration**
   Guide for upgrading to ActingWeb 3.1, including changes to the developer API, unified access control, and handler architecture.

Common Issues
=============

**Common Pitfalls**
   Frequently encountered issues and their solutions when working with ActingWeb.

Migration Checklist
===================

When upgrading ActingWeb:

1. Read the relevant migration guide
2. Review breaking changes
3. Update your configuration
4. Test in development environment
5. Run your test suite
6. Deploy with monitoring

See Also
========

- :doc:`../quickstart/configuration` - Configuration reference
- :doc:`../guides/troubleshooting` - Troubleshooting guide
- `CHANGELOG <https://github.com/actingweb/actingweb/blob/master/CHANGELOG.rst>`_ - Full changelog