reordered api.md + random wip