Skip to content

Commit 0132d6e

Browse files
committed
API documentation: Change the URL to https://randruc.github.io/Lazuli/doxygen/latest/
* Also add the corresponding information in README and in Sphinx documentation.
1 parent 2622dd1 commit 0132d6e

File tree

5 files changed

+20
-10
lines changed

5 files changed

+20
-10
lines changed

.github/workflows/publish_doxygen_documentation.yml

+2-2
Original file line numberDiff line numberDiff line change
@@ -34,10 +34,10 @@ jobs:
3434
run: git fetch && git checkout gh-pages
3535

3636
- name: Prepare the directory
37-
run: rm -rf doxygen/head && mkdir -p doxygen/head
37+
run: rm -rf doxygen/latest && mkdir -p doxygen/latest
3838

3939
- name: Copy Doxygen artifacts
40-
run: cp -r doxygen_output/html/* doxygen/head/
40+
run: cp -r doxygen_output/html/* doxygen/latest/
4141

4242
- name: Get rid of doxygen output
4343
run: rm -rf doxygen_output

README.md

+9-7
Original file line numberDiff line numberDiff line change
@@ -62,19 +62,21 @@ The Lazuli project has very specific goals that make it unique. These are:
6262
code or behavior, this is considered as a bug.
6363

6464

65-
## Examples
66-
67-
Example programs that use the Lazuli RTOS can be found in the directory
68-
[example-programs/](example-programs/).
69-
70-
7165
## Documentation
7266

7367
The documentation for the project can be found in the [doc/](doc/) directory.
7468

69+
API documentation can be read at https://randruc.github.io/Lazuli/doxygen/latest/
70+
7571
Two different tools are used to document the project:
7672
* `sphinx` to generate user documentation from files written in reStructuredText.
77-
* `doxygen` to generate API documentation from code comments..
73+
* `doxygen` to generate API documentation from code comments.
74+
75+
76+
## Examples
77+
78+
Example programs that use the Lazuli RTOS can be found in the directory
79+
[example-programs/](example-programs/).
7880

7981

8082
## Prerequisites

doc/index.rst

+3
Original file line numberDiff line numberDiff line change
@@ -36,3 +36,6 @@ of Lazuli.
3636
developing_your_project
3737
kernel/kernel_documentation
3838
glossary
39+
40+
If you wish to read the API documentation, please browse to
41+
`<https://randruc.github.io/Lazuli/doxygen/latest/>`_

doc/kernel/about_documentation.rst

+3
Original file line numberDiff line numberDiff line change
@@ -84,6 +84,9 @@ Doxygen
8484
The other kind of documentation comes from code comments with Doxygen commands.
8585
The official website of Doxygen is `<https://www.doxygen.nl>`_
8686

87+
The API documentation for the project is hosted at
88+
`<https://randruc.github.io/Lazuli/doxygen/latest/>`_
89+
8790
Code comments
8891
^^^^^^^^^^^^^
8992

src/doxygen_main_page.dox

+3-1
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,9 @@
1010
* This is the Lazuli kernel API and user API documentation. @n
1111
* @n
1212
* These pages only document the APIs. For more general documentation about
13-
* the project and use cases please refer to the corresponding documentation.
13+
* the project and use cases please refer to the corresponding documentation. @n
14+
*
15+
* The project is hosted at https://github.com/randruc/Lazuli @n
1416
*
1517
*
1618
* @section user_api_subsection User API

0 commit comments

Comments
 (0)