Deprecate agent_portrayal and update Migration guide

[Sahil-Chhoker]

Summary

Updates the migration guide inline with the new visualization API. Also activates the deprecation warnings for portrayal components.

Motive

Updating the migration guide to help users upgrade to the latest Mesa version.

Implementation

Documented API changes with a comparison between the old and new versions.

[Sahil-Chhoker]

@EwoutH, I've updated the migration guide for the portrayal components as I just had to add a new section there, but how do I go about updating the space visualization as it already contains a block, should we separate the changes according to the mesa versions?

[github-actions]

Performance benchmarks:

Model	Size	Init time [95% CI]	Run time [95% CI]
BoltzmannWealth	small	🔵 +3.0% [+1.8%, +4.1%]	🔵 +0.5% [+0.3%, +0.6%]
BoltzmannWealth	large	🔵 -0.3% [-1.2%, +0.7%]	🔵 -2.8% [-5.6%, +0.2%]
Schelling	small	🔵 -0.6% [-0.9%, -0.3%]	🔵 -0.2% [-0.5%, +0.1%]
Schelling	large	🔵 -0.2% [-0.5%, +0.1%]	🔵 +1.3% [-0.3%, +2.8%]
WolfSheep	small	🔵 -0.6% [-0.9%, -0.3%]	🔵 -0.4% [-0.6%, -0.2%]
WolfSheep	large	🔵 +0.7% [-0.5%, +2.2%]	🔵 -2.8% [-3.9%, -1.4%]
BoidFlockers	small	🔵 -0.5% [-1.0%, +0.0%]	🔵 -0.4% [-0.6%, -0.1%]
BoidFlockers	large	🔵 -0.4% [-0.7%, -0.1%]	🔵 -0.5% [-0.8%, -0.3%]

[EwoutH]

but how do I go about updating the space visualization as it already contains a block, should we separate the changes according to the mesa versions?

Yes, this document just keeps on growing. So add it under the first version that the new things works and users can (should) use it.

[Sahil-Chhoker]

This is the version I could come up with without repeating myself too much, let me know if it need improvement.

[EwoutH]

Great start, thanks. A few comments.

[tpike3]

This is great @Sahil-Chhoker, thanks for doing this!

[EwoutH]

We can remove this line, since it no longer applies (the guide is done).

Suggested change

	_This guide is a work in progress. The development of it is tracked in [Issue #2233](https://github.com/projectmesa/mesa/issues/2233)._

[EwoutH]

This is great, thanks!

Once you're ready, I can believe you can now merge yourself :)
(highly recommend squashing while merging)

We shouldn't forget to include this deprecation clearly in the release notes on the next release.