cal.pub0.org/apps/docs
Agusti Fernandez Pardo 71e67b50b2
Fix: Improve docs and mobile style of api docs (#2635)
* fix: adds servers in openapi, remove hack in snippets, update deps, make dynamic import to use latests swagger ui deps

* fix: remove unneded import

* fix: adds yarn dev commands for api and swagger

* fix: prisma not web before api

* fix: improve mobile docs api

* fix request snippets

* fix: custom more visible scrollbar for snippets in moible

* fix: remove comments and ugly scrollbar

* fix: types and remove lib url

* fix: install iframe-react-resizer in docs

* fix: remove web scope from yarn dev:api

* fix: remove json-schema autogenerated as wont be used

* fix: apiKeyAuth

* fix: swagger patch thx hariom

* fix: add api to env/example

Co-authored-by: Agusti Fernandez Pardo <git@agusti.me>
Co-authored-by: kodiakhq[bot] <49736102+kodiakhq[bot]@users.noreply.github.com>
Co-authored-by: zomars <zomars@me.com>
2022-05-05 09:36:02 -06:00
..
components Embed Snippet Generator (#2597) 2022-05-05 08:29:49 -06:00
lib Fix: Improve docs and mobile style of api docs (#2635) 2022-05-05 09:36:02 -06:00
pages Fix: Improve docs and mobile style of api docs (#2635) 2022-05-05 09:36:02 -06:00
public Migrate docs to mono repo (#1814) 2022-02-11 12:33:35 -07:00
.gitignore Migrate docs to mono repo (#1814) 2022-02-11 12:33:35 -07:00
.nvmrc Migrate docs to mono repo (#1814) 2022-02-11 12:33:35 -07:00
.prettierignore Migrate docs to mono repo (#1814) 2022-02-11 12:33:35 -07:00
LICENSE Migrate docs to mono repo (#1814) 2022-02-11 12:33:35 -07:00
README.md Update README.md 2022-04-30 15:55:25 +02:00
next-env.d.ts Eslint fixes (#1898) 2022-02-18 16:53:45 +00:00
next.config.js Adds iframe to developer.cal.com (swagger-ui) into docs/public-api.mdx (#2518) 2022-04-15 23:56:32 +00:00
package.json Fix: Improve docs and mobile style of api docs (#2635) 2022-05-05 09:36:02 -06:00
theme.config.js Linting (#2083) 2022-03-09 17:52:48 +00:00
tsconfig.json Updating contributing to app store docs (#2433) 2022-04-08 15:59:51 +01:00
yarn.lock Migrate docs to mono repo (#1814) 2022-02-11 12:33:35 -07:00

README.md

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

  1. From the documentation's GitHub repository, head to the folder called 'pages' and open it.
  2. From here you can view all current pages on the documentation site. Select the page you would like to contribute to.
  3. 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.
  4. From here make the changes you wish to make.
  5. 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.
  6. Your changes have been saved, to submit them for review, located on your screen, press the green 'Create Pull Request' button.
  7. 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

  1. From the documentation's GitHub repository, head to the folder called 'pages' and open it.
  2. From here you can view all current pages on the documentation site. At the top of your screen press the 'New file' button.
  3. 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.
  4. From here make the changes you wish to make. Such as creating a title, sub-title and body text.
  5. 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.
  6. Your changes have been saved, to submit them for review, located on your screen, press the greem 'Create Pull Request' button.
  7. 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.