I believe that the only reason current document resides on the gitbook was that person who wrote the documentation(me) did not know another way.
If we can reference other project and find out the better way, I would be happy to help. I agree that maintaining documentation on the same repository as source code would be better way, but I do not know how to start. It would be great if you can show around how we can do this. On Wed, Nov 7, 2018 at 12:23 PM daewon <dae...@apache.org> wrote: > How to use s2grpah can be found in the repository's README.md file and in > the Gitbook (https://steamshon.gitbooks.io/s2graph-book/content/) > > I think there are some problems with how to use s2graph. > 1. The README.md file does not describe all the APIs. > ex) Absence of admin API description > > 2. The Gitbook does not support changes based on the release version. > ex) No description for new API: Vertex search query > > For these reasons, I think it would be nice if the documentation source is > in the same repository as the code source. > > I've looked at a similar example, and Python seems to be using it this way. > ex) https://github.com/python/cpython/tree/master/Doc > > I think s2graph is better to manage documents like Python in the source > code repository. > > I look forward to feedback. >