Revamp documentation, use `Documenter.jl` to generate API docs

[dhanak]

• revise docstrings to follow the general Julia documentation guidelines;
• use Documenter.jl to generate full documentation;
• add doctests to the docstrings where feasible;
• extend CI pipeline to automatically generate and publish documentation to GitHub Pages.