docs(examples): simplify the barchart example

[joshka]

• Simplify the rendering functions
• Fix several clippy lints that were marked as allowed
• Extract a common.rs for terminal initialization and error handling

[joshka]

I made a bunch of changes:

• removed the prelude
• revamped the way the data for the companies was stored to simplify the conversion into bars (i.e. it's stored as months containing revenues for each company rather than companies containing revenues for each month
• moved a bunch of things around
• tightened up pretty much everything
• added comments where they would normally be needed.

[joshka]

The idea behind this is to do similar changes to all the examples, and to make them take this form.

[joshka]

fix: tweaks

• Move constants closer to their usage
• add an exit field to app
• extract methods from the main loop to make the flow clearer
• move update handling to use a field on app instead of a variable in the loop
• rename last_tick to last_update to make it clearer what it controls

[EdJoPaTo]

Given that there are other Repos with widget examples… how about a ratatui feature for an example base? Other widgets in other repos can also use them as a common base to demonstrate their widgets then.

[joshka]

Given that there are other Repos with widget examples… how about a ratatui feature for an example base? Other widgets in other repos can also use them as a common base to demonstrate their widgets then.

An example is just an app. Adding code to make writing examples easy is adding code to make writing apps easy. There shouldn't be an "example base", there should be functions that make using common parts of ratatui easy. Those changes are more difficult than cleaning up existing code to make it easier for new users to understand.

[EdJoPaTo]

Given that there are other Repos with widget examples… how about a ratatui feature for an example base? Other widgets in other repos can also use them as a common base to demonstrate their widgets then.

An example is just an app. Adding code to make writing examples easy is adding code to make writing apps easy. There shouldn't be an "example base", there should be functions that make using common parts of ratatui easy. Those changes are more difficult than cleaning up existing code to make it easier for new users to understand.

This creates a common example base. My point is to make this common.rs reusable for other repos too, not just examples within the ratatui repo. That way they can also be more consistent.

[joshka]

I think it might be better to incorporate that file in each example instead as it makes each example self contained as a single file.

Publishing public code locks you into supporting it and not making changes that would break code that uses it. I'd prefer this code to be copied instead of referenced.