Add documentation and examples for Numba acceleration

[suryanshgargbpgc]

We have Numba integration in Sugarscape example, but no proper comprehensive doc on how to effectively use it for other models.
Numba's usage isn't well-documented in the main documentation. The Sugarscape example shows how it's used, but this approach isn't generalized or explained in a way that would help users implement similar acceleration for other models.

[adamamer20]

Sure, that's a great idea!

[suryanshgargbpgc]

@adamamer20 should we add numba as an optional dependency ?

[adamamer20]

@adamamer20 should we add numba as an optional dependency ?

yes, it makes sense