2021-06-12 00:49:00 +00:00
|
|
|
# Objective-C API Documentation
|
|
|
|
|
|
|
|
|
|
The API should be documented with comments in the [public header files](../include).
|
|
|
|
|
|
|
|
|
|
## Documentation Generation
|
|
|
|
|
|
|
|
|
|
The [Jazzy](https://github.com/realm/jazzy) tool is used to generate documentation from the code.
|
|
|
|
|
|
2023-04-07 22:00:15 +00:00
|
|
|
To generate documentation, from the repo root, run:
|
2021-06-12 00:49:00 +00:00
|
|
|
|
|
|
|
|
```bash
|
2022-03-04 06:02:53 +00:00
|
|
|
jazzy --config objectivec/docs/jazzy_config.yaml --output <output directory>
|
2021-06-12 00:49:00 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
|
|
The generated documentation website files will be in `<output directory>`.
|
|
|
|
|
|
2023-04-07 22:00:15 +00:00
|
|
|
[main_page.md](./main_page.md) contains content for the main page of the generated documentation website.
|