Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Package and API Docs building & Hosting #264

Closed
amjadraza opened this issue Jul 14, 2023 · 1 comment · Fixed by #287
Closed

Package and API Docs building & Hosting #264

amjadraza opened this issue Jul 14, 2023 · 1 comment · Fixed by #287

Comments

@amjadraza
Copy link
Contributor

Feature: Enhancement

Adding Documentation and API guide. I propose two frameworks

A. Using Pythonic Sphnix Framework and deploying on the readthedocs server

  1. Open Source, comes with many themes / templates
  2. Extensively used for Python Packages e.g LangChain API is using the readthedocs template of Sphnix
  3. Have support of .rst , .mk and much more formats

B. Using mkdocs framework

  1. Light framework based on Python, Pandas-ai is using this
  2. Support MarkDown files
  3. Comes with material and readthedocs templates.

C. Using Vercel Documentations

  1. https://nextra-docs-template.vercel.app/
  2. API reference guide still using Sphnix
  3. LangChain is using this platform too

DocString Styles: Among many docstrings styles, Google Style is very famous and easy to implement.

It is important to decide on Documentation Especially Docstrings early on to generate the API reference Guide professionally. Re-Factoring a huge code base with Docstring is a huge job.

I can contribute to this feature.

@amjadraza
Copy link
Contributor Author

@taranjeet @deshraj What do you guys say?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging a pull request may close this issue.

1 participant