* Moved prisma to packages * Add missing prisma configs * Extracts common libs and types * Build and pipeline fixes * Adds missing package * Prisma scripts cleanup * Updates lint staged * Type fixes * Sort imports * Updates yarn lock file * Fixes for yarn dx * Revert "Sort imports" This reverts commit 076109decab9b9ba307fc03696c3b0da5c4896f3. * Formatting * Prevent double TS version * Fix conflict * Extracted e2e configs
3.7 KiB
Cal.com Documentation
The official product, support and developer documentation, containing information and guides about using the product as well as support for self-hosted installations. This documentation site runs on Nextra, so you may refer to their documentation should you need information on anything that isn't covered here.
Prerequisites
- Git
- Node.js & npm
- Yarn
Installation
Firstly, clone the repository using Git:
git clone https://github.com/calcom/docs.git
Now, you can install the dependencies with yarn:
yarn install
Editing
To create, edit and delete documentation pages, you can simply create markdown (.mdx) files in the pages/
folder. You can edit Markdown with any text editor, but VS Code and WebStorm have side-by-side previews so you can see your formatted content whilst writing markdown.
You will also need to add it as an entry to the meta.json
file found in whichever directory that the .mdx file is in.
Local Development
yarn dev
This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
Build
yarn build
This command generates static content into the build
directory and can be served using any static content hosting service.
How to easily contribute
Existing Page
- From the documentation's GitHub repository, head to the folder called 'pages' and open it.
- From here you can view all current pages on the documentation site. Select the page you would like to contribute to.
- You should now be able to view the page you have selected. Located at the top right of the page will be a pencil icon. Pressing this will bring you up an editor to edit and make changes. You can add formatting using the buttons at the top, which will automatically insert the relevant markdown content needed to style the text.
- From here make the changes you wish to make.
- At the bottom of the screen will be a 'Propose Changes' box, fill in all the relevant details such as title and description then press the green 'Propose Changes' button.
- Your changes have been saved, to submit them for review, located on your screen, press the green 'Create Pull Request' button.
- Fill in all the relevant details such as title and description and after finalize the submission.
You have now successfully edited and submitted changes to our documentation site.
Creating a New Page
- From the documentation's GitHub repository, head to the folder called 'pages' and open it.
- From here you can view all current pages on the documentation site. At the top of your screen press the 'New file' button.
- You should now be able to view the page you have created. Remember when renaming the document to put .mdx at the end of the file name.
- From here make the changes you wish to make. Such as creating a title, sub-title and body text.
- At the bottom of the screen will be a 'Propose Changes' box, fill in all the relevant details such as title and description then press the green 'Propose Changes' button.
- Your changes have been saved, to submit them for review, located on your screen, press the greem 'Create Pull Request' button.
- Fill in all the relevant details such as title and description and after finalize the submission.
You have now successfully created and submitted changes to our documentation site.