github.com/argoproj/argo-cd/v3@v3.2.1/docs/developer-guide/docs-site.md (about)

     1  # Documentation Site
     2  
     3  ## Developing And Testing
     4  
     5  The [documentation website](https://argo-cd.readthedocs.io/) is built using `mkdocs` and `mkdocs-material`.
     6  
     7  To test:
     8  
     9  ```bash
    10  make serve-docs
    11  ```
    12  Once running, you can view your locally built documentation at [http://0.0.0.0:8000/](http://0.0.0.0:8000/).
    13  Making changes to documentation will automatically rebuild and refresh the view.
    14  
    15  Before submitting a PR build the website, to verify that there are no errors building the site
    16  ```bash
    17  make build-docs
    18  ```
    19  
    20  If you want to build and test the site directly on your local machine without the use of docker container, follow the below steps:
    21  
    22  1. Install the `mkdocs` using the `pip` command
    23      ```bash
    24      pip install mkdocs
    25      ```
    26  2. Install the required dependencies using the below command
    27     ```bash
    28     pip install $(mkdocs get-deps)
    29      ```
    30  3. Build the docs site locally from the root
    31     ```bash
    32     make build-docs-local
    33     ``` 
    34  4. Start the docs site locally
    35     ```bash
    36     make serve-docs-local
    37     ```
    38  
    39  ## Analytics
    40  
    41  !!! tip
    42      Don't forget to disable your ad-blocker when testing.
    43  
    44  We collect [Google Analytics](https://analytics.google.com/analytics/web/#/report-home/a105170809w198079555p192782995).