Create new BSP manual

Summary

RTEMS has a lot of README.md files in bsp/*. We have not wanted documentation in source for a long time as this promotes not being updated. We've decided the best course of action is to create a new manual specifically targeted at BSPs.

The goal is a user could use the getting started guide + the BSP manual to get up and running with RTEMS.

What needs to be decided

1. Do we have one entry per BSP, always?
   1. If so we could extract name, title, location and some simple details and settings from the source repository for an 'auto generated' portion. This would optionally require having RTEMS source available when building the docs to have the autogenerated docs inserted.
2. What will go into the document will it be user docs strictly? What if a BSP has any engineering information
   1. I think it makes sense to keep the engineering documents with other engineering docs.
3. Should all user-based documentation pretaining to BSPs be moved to this?

Possible layout

1. Getting started
   1. Short introduction
   2. Link to getting started manual
2. Architecture
   1. BSP
   2. ""

Section layout

Part of this will be auto generated and the other will be manually edited.

If a BSP does not have any handwritten content then only the auto generated content will be available. It's still to be determined if we can autogenerate anything that is useful for users it's better to not have an endless list of repetitive content but if we can do get something useful and collect enough we can go this route.

• Note: This would be written in such a way that if autogeneration is not used then the document can still be built with only the handwritten portions.