I am intrigued by the new StackOverflow documentation. However I am not convinced on how this is all setup and hoping some discussion might help to sort things out.
Take for example Custom Renderers Topic Request for Xamarin Forms.
When you go to create the Topic you are presented with these things
It says all good documentation starts with examples. But I am disagreeing on this point for this topic. For example look at the description added:
Strategy for custom renderers, why what when how
There is no one example for a custom renderer and I don't even think it should start with that. I would initially start with a description and diagram on the concept of custom renderers.
Examples come next, but example for what? You can either do your own custom renderer or extend one of Xamarin Forms existing ones. In which case do we need a new topic for each one, expanding LabelRenderer for example, otherwise the list of examples will be completely overwhelming.
There doesn't seem to be anyway to tie this all together. However I may be looking at this documentation concept incorrectly and should we just be doing a documentation piece for LabelRenderer for example, without having the overview explaining the concepts first or bothering to link the others together?
Apologies, I am going to tag in a bunch of people here otherwise they won't see it and I know they will most likely have some good discussion points around this: @CraigDunn @PaulDiPietro @NMackay @GeraldVersluis @JohnHardman @KymPhillpotts @AlessandroCaliaro @ThomasBurkhart