rewritte old proposal api documentation to markdown

"from yast2" seems to have dropped in the middle of the sentence breaking the reading flow. What about?
```
It is recommended to use Installation::ProposalClient as base class for new clients. This base class, implemented in yast2-yast, provides automatic method dispatching.
```