docs: enhance the documentation and add inline code examples

docs: enhance the documentation and add inline code examples #612