Suggest implementation technology for documentation site about langchaingo

[mfreeman451]

Going to set this up on something locally and get familiar https://gohugo.io/hosting-and-deployment/hosting-on-github/

[tmc]

We should use the best tool that gets us an experience like the other sites. I prefer a go based tool for sure but am not going to be dogmatic about it.

edit: Updated issue indicating the technologies the python and ts implementations use. I'd love to use hugo but someone needs to demonstrate that it's going to work well.

[nguyenvanduocit]

Another tools is Vitepress, it's a is battery-included site generator for technical docs. take a look at : https://vitepress.dev/

[ChristianSch]

I think a go project lends itself for documentation in go without introducing another toolchain

[ChristianSch]

Maybe we could clarify the needs beforehand. There are two different documentation areas I guess: the package API (godoc) and the "user guide".

Additionally, something like this might be useful:

• https://github.com/robertkrimen/godocdown
• https://github.com/princjef/gomarkdoc

What I missed with hugo was a good documentation template but I just found this one: https://themes.gohugo.io/themes/doks/

[tmc]

I like https://themes.gohugo.io/themes/docsy/ but we'd need some theming to match the existing docs sites (https://python.langchain.com/en/latest/, https://js.langchain.com/docs/).

I think we should go Hugo+Docsy+(custom theming) or Docusarus.

[deshetti]

@tmc My 2 cents.

Docusaurus is pretty straight forward and will match the docs site like here: https://js.langchain.com/docs/ as it seems like pretty much OOB theme.

The time would be well worth spending on implementing core features than having a customized theme IMO.

[tmc]

@tmc My 2 cents.

Docusaurus is pretty straight forward and will match the docs site like here: https://js.langchain.com/docs/ as it seems like pretty much OOB theme.

The time would be well worth spending on implementing core features than having a customized theme IMO.
Yeah I've come to agree. Docusaurus it is!