Commentasaurus
Inline feedback, made simple
Abstract
Commentasaurus is a plugin for Docusaurus that enables inline comments within your documentation pages, letting users give direct feedback on specific sections of text, similar to Google Docs.
Tech Stack
| Layer | Technologies | Description |
|---|---|---|
| Frontend | Docusaurus, TypeScript | Renders the documentation and plugin interface |
| Backend | Go | Handles comment APIs and authentication |
| Storage | GitHub Discussions | Comments are stored using GitHub Discussions for collaboration and transparency |
Getting Started
Folder Structure
.
├── backend/
│ ├── main.go # Golang API entrypoint
│ ├── routes/ # HTTP handlers and routing
│ └── ...
│
├── documentation/
│ ├── docs/ # Markdown documentation about the plugin
│ ├── docusaurus.config.ts # Docusaurus config (plugin settings live here)
│ └── plugins/
│ └── commentasaurus/ # Local path to test the plugin inside Docusaurus
│
└── plugin/
└── src/ # Source code of the plugin to be published to npm
The /plugin directory should mirror the version under /documentation/plugins/commentasaurus to ensure consistency when testing.
Running Locally
Backend (Go API)
cd backend
go run ./cmd/server/main.go
By default, the API runs on http://localhost:8080
There is also a Dockerfile that can be used
Documentation site
cd documentation
npm install
npm run start
This will open http://localhost:3000 for you.
Environment Variables
DOCKER_TAG=< Where the docker image should be uploaded to>
GITHUB_TOKEN=< GitHub token required for allowing unauthenticated users > OAUTH_ClIENT_ID=< Client ID of GitHub OAuth App > OAUTH_SECRET=< Secret from GitHub OAuth App > JWT_SECRET=< Random long string > COOKIE_KEY=< 32bit str for cookie encryption >
See the example Docusaurus config for setting up the plugin.
Preview
TODO
Contributing
I welcome contributions! Please open issues, submit pull requests, or reach out with suggestions.
- Fork the repo
- Create your branch (
git checkout -b feature/thing) - Commit your changes (
git commit -am 'Add thing') - Push to the branch (
git push origin feature/thing) - Open a pull request
License
This project is licensed under the MIT License. See LICENSE for details. While not required by the license, contributions back to this repository for any fixes or improvements are greatly appreciated.
Collaborators
 Nick Rucinski |