augraphy icon indicating copy to clipboard operation
augraphy copied to clipboard

Add documentation in a dedicated hosting site.

Open kwcckw opened this issue 3 years ago • 3 comments

I think it will be better if there's a proper documentation site instead of having the documentation inside the github repo.

kwcckw avatar Jul 06 '22 01:07 kwcckw

I believe we wanted all of the documentations in the github repo since it is easily accessible from the actual code and to anyone looking at the library. However, if we house this library somewhere else, we will definitely make a website for the documentation.

samaymaini avatar Jul 06 '22 17:07 samaymaini

Most of the popular open source libraries are using auto-generated documentation that is built based on the repo. We should find a good model repo to copy their pattern. ReadTheDocs offers a free option for open source, but perhaps there are others we should consider when the time is right.

jboarman avatar Jul 06 '22 18:07 jboarman

auto-generated documentation that is built based on the repo

Okay, and i think this will be a better choice instead of rewrite the whole documentations, so probably we can list down some of the reference repo who use this kind of documentation first.

kwcckw avatar Jul 07 '22 01:07 kwcckw

The latest documentation is added here:

https://the-augraphy-project-augraphy.readthedocs-hosted.com/en/latest/

kwcckw avatar Sep 15 '22 05:09 kwcckw