Api docs refactor

!! Don't merge. Just review !!

New api docs.
@idradm @Szumo @ukaka @RodriGomez