Skip to content

Commit 894e48c

Browse files
committed
Add api overview generation to readme
1 parent c51167e commit 894e48c

File tree

1 file changed

+11
-1
lines changed

1 file changed

+11
-1
lines changed

README.md

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -88,11 +88,21 @@ Lazydocs tries to automatically
8888
This is
8989

9090
```bash
91-
lazydocs --src-base-url=https://github.com/example/my-project/blob/main/ my_package
91+
lazydocs --src-base-url="https://github.com/example/my-project/blob/main/" my_package
9292
```
9393

9494
### API Overview
9595

96+
An API overview might be very useful in case your project has a large number modules, classes and functions. You can specify an `overview-file` with the lazydocs command to activate the generation of an API overview:
97+
98+
```bash
99+
lazydocs --overview-file="README.md" my_package
100+
```
101+
102+
The API Overview will be written as markdown to the specified file with sperated lists for all modules, classes, and functions of your project:
103+
104+
<img style="width: 100%" src="./docs/images/api-overview.png"/>
105+
96106
### MKDocs Integration
97107

98108
### Docstyle Validation

0 commit comments

Comments
 (0)