Skip to content

Commit c51167e

Browse files
committed
Document some features
1 parent 6da743d commit c51167e

File tree

1 file changed

+25
-4
lines changed

1 file changed

+25
-4
lines changed

README.md

Lines changed: 25 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -38,8 +38,6 @@ Lazydocs makes it easy to generate beautiful markdown documentation for your Pyt
3838

3939
> _Requirements: Python 3.6+._
4040
41-
To install lazydocs, simply execute:
42-
4341
```bash
4442
pip install lazydocs
4543
```
@@ -58,7 +56,7 @@ The path can be either a python package (folder) or a specific script. You can a
5856
lazydocs my_package.AwesomeClass
5957
```
6058

61-
With the default configuration, the Markdown documentation will be generated inside a `./docs` in your working directory. You can find additional configuration options in the documentation section.
59+
With the default configuration, the Markdown documentation will be generated inside the `./docs` folder in your working directory. You can find additional configuration options in the [documentation section](#cli-interface).
6260

6361
## Support & Feedback
6462

@@ -83,22 +81,45 @@ This project is maintained by [Benjamin Räthlein](https://twitter.com/raethlein
8381

8482
### Source Code Linking
8583

84+
Lazydocs tries to automatically
85+
86+
87+
88+
This is
89+
90+
```bash
91+
lazydocs --src-base-url=https://github.com/example/my-project/blob/main/ my_package
92+
```
93+
8694
### API Overview
8795

8896
### MKDocs Integration
8997

9098
### Docstyle Validation
9199

100+
Lazydocs can only parse valid Google-style docstring. To prevent the generation of invalid markdown documentation, you can use the `validate` flag:
101+
102+
```bash
103+
layzdocs --validate my_package
104+
```
105+
106+
This will run [pydocstyle](https://github.com/PyCQA/pydocstyle) on your docstring and cancel the generation if an issue is found.
107+
92108
### Console Output
93109

110+
To get the markdown documentation as console output instead of the file generation, specify `stdout` as the `output-path`:
111+
112+
```bash
113+
layzdocs --output-path=stdout my_package
114+
```
94115

95116
## Documentation
96117

97118
### CLI Interface
98119

99120
<!-- generated via typer-cli: typer src/lazydocs/_cli.py utils docs -->
100121

101-
```console
122+
```bash
102123
laydocs [OPTIONS] PATHS...
103124
```
104125

0 commit comments

Comments
 (0)