To try out Doclin, install the extension in VS Code. Link to VS Code Marketplace.
Currently only supports VS Code, but to be extended to other IDEs once we validate the concept.
The purpose of this tool is to build code knowledgebase easily. Traditional code documentation methods are very inefficient. Developers write the documentation simultaneously as their code, which often results in documents that are time-consuming, unhelpful, and missing important points. Above all, it gets out of date quickly and becomes a burden to maintain it. We realized it is more helpful to document the answers when someone asks a question or faces a problem. This ensures the documentation is more meaningful, and we can spend less time writing documentation.
Doclin is still in a very early stage. If you like the idea, please star the repo to show support and use the discussions tab to leave feedback.
- Node.js: Ensure you have Node.js installed (minimum version required: 14.x or higher).
- PostgreSQL: Make sure you have a PostgreSQL database set up and running.
- VS Code: Ensure you have the latest version of VS Code installed.
- Install docker version >= 27.1.1
- Fill up the credentials in .env file
- GITHUB_CLIENT_SECRET and GITHUB_CLIENT_ID - These are used for the github login. Get these by creating a Github app.
- SENDGRID_API_KEY - This is used for email notifications when someone is tagged on a thread. Get your own api key from Sendgrid.
- OPENAI_API_KEY - This is used for the copilot.
docker compose up
On Visual Studio Code, open the repository. Then on the top bar, select Run, then Start Debugging (F5).
Visit http://localhost:3002
See CONTRIBUTING.md for ways you can contribute to Doclin.