Skip to content

doclin-dev/doclin

Repository files navigation

Doclin

Real-time code discussion and documentation on your IDE

Deploy Status

Getting Started

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.

What is Doclin?

Purpose

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.

Usage

  1. Ask questions on code from your IDE!
    Ask question on Doclin

  2. Get answers in real-time.
    Get answers on Doclin

  3. Discussions stay coupled with the code.
    image

Local Setup Instructions

Pre-requisites

  1. Node.js: Ensure you have Node.js installed (minimum version required: 14.x or higher).
  2. PostgreSQL: Make sure you have a PostgreSQL database set up and running.
  3. VS Code: Ensure you have the latest version of VS Code installed.

Run the server

  1. Install docker version >= 27.1.1
  2. Fill up the credentials in .env file
    1. GITHUB_CLIENT_SECRET and GITHUB_CLIENT_ID - These are used for the github login. Get these by creating a Github app.
    2. SENDGRID_API_KEY - This is used for email notifications when someone is tagged on a thread. Get your own api key from Sendgrid.
    3. OPENAI_API_KEY - This is used for the copilot.
docker compose up

Run the extension

On Visual Studio Code, open the repository. Then on the top bar, select Run, then Start Debugging (F5).

Run the webapp

Visit http://localhost:3002

Contributing

See CONTRIBUTING.md for ways you can contribute to Doclin.