Refactoring credit docs for better rendering

@stuartw Can you take a look?