docs.plus is a free, real-time collaboration tool built on open-source technologies. It empowers communities to share and organize information logically and hierarchically, making teamwork and knowledge sharing straightforward and effective.
Prerequisites:
- Node.js (version ">=18.15.0")
- Yarn
- PostgreSQL (downloadable from the official PostgreSQL website) or Docker for running a PostgreSQL container.
docs.plus is organized as a monorepo and uses Yarn Workspaces and Lerna for managing dependencies and synchronizing versions across different packages.
Follow these steps to get started with docs.plus:
# Clone the repository
$ git clone https://github.com/docs-plus/docs.plus.git
# Navigate to the project directory
$ cd docs.plus
# Install dependencies
$ yarn
Set up a PostgreSQL database accessible to your development environment. If using Docker, here's a basic command to start a PostgreSQL container:
docker run --name some-postgres -e POSTGRES_PASSWORD=mysecretpassword -d postgres
More details on the PostgreSQL Docker image are available in the official Docker documentation.
Unix-based systems (macOS, Linux):
$ yarn start
Windows systems: Ensure PowerShell is installed. Then, to start the development servers, open three separate PowerShell windows and run the following commands:
# PowerShell Window 1
cd .\packages\hocuspocus.server\
npm run dev
# PowerShell Window 2
cd .\packages\hocuspocus.server\
npm run dev:ws
# PowerShell Window 3
cd .\packages\webapp\
npm run dev
💡 We're actively seeking contributors to improve our Windows setup instructions. If you can assist, we'd be thrilled! Your contribution will enhance the accessibility of docs.plus for Windows users and foster our community's growth. All collaboration is warmly welcomed!
$ docker-compose up
We'd love to hear from you! Join our Discussions, or reach out through:
- Twitter: @docsdotplus
- Github: docs.plus
- Slack: docsplus
- Email: contact@newspeak.house
docs.plus is under the Apache License v2, granting you freedom to use, modify, distribute, and even sell your modifications under the same terms.
docs.plus is free and open-source. Keeping it running and
continuously improving requires resources. If you're able to support us, we'd greatly appreciate it:
Your support maintains our servers and enhances this platform for everyone's benefit. Thank you for your generosity!