Explain up-front what bionic actually _is_.

Also fix formatting of "What's in libc/?" section, and remove obsolete
include/machine.

Also unify # vs --- syntax.

Bug: N/A
Test: N/A
Change-Id: I6a7a2828e700d5e03c7209f55691278326230bd1