Skip to content

Commit 18ddd16

Browse files
authored
Merge pull request #1013 from PowerGridModel/feature/markdown-line-length
Documentation: markdown line length 120
2 parents 05edd08 + e2a6fac commit 18ddd16

File tree

28 files changed

+1446
-1160
lines changed

28 files changed

+1446
-1160
lines changed

.markdownlint.yaml

Lines changed: 6 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -5,24 +5,12 @@
55
# MD001/heading-increment : Heading levels should only increment by one level at a time : https://github.com/DavidAnson/markdownlint/blob/v0.37.4/doc/md001.md
66
MD001: false
77

8-
# MD013/line-length : Line length : https://github.com/DavidAnson/markdownlint/blob/v0.37.4/doc/md013.md
9-
MD013: false
10-
# # Number of characters
11-
# line_length: 80
12-
# # Number of characters for headings
13-
# heading_line_length: 80
14-
# # Number of characters for code blocks
15-
# code_block_line_length: 80
16-
# # Include code blocks
17-
# code_blocks: true
18-
# # Include tables
19-
# tables: true
20-
# # Include headings
21-
# headings: true
22-
# # Strict length checking
23-
# strict: false
24-
# # Stern length checking
25-
# stern: false
8+
# MD013/line-length : Line length : https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md013.md
9+
line-length:
10+
line_length: 120
11+
code_blocks: false
12+
tables: false
13+
stern: true
2614

2715
# MD024/no-duplicate-heading : Multiple headings with the same content : https://github.com/DavidAnson/markdownlint/blob/v0.37.4/doc/md024.md
2816
MD024: false

README.md

Lines changed: 27 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ SPDX-FileCopyrightText: Contributors to the Power Grid Model project <powergridm
44
SPDX-License-Identifier: MPL-2.0
55
-->
66

7-
[![PyPI version](https://badge.fury.io/py/power-grid-model.svg?no-cache)](https://badge.fury.io/py/power-grid-model) <!-- markdownlint-disable-line first-line-h1 -->
7+
[![PyPI version](https://badge.fury.io/py/power-grid-model.svg?no-cache)](https://badge.fury.io/py/power-grid-model) <!-- markdownlint-disable-line first-line-h1 line-length -->
88
[![Anaconda-Server Badge](https://anaconda.org/conda-forge/power-grid-model/badges/version.svg?no-cache)](https://anaconda.org/conda-forge/power-grid-model)
99
[![License: MPL2.0](https://img.shields.io/badge/License-MPL2.0-informational.svg)](https://github.com/PowerGridModel/power-grid-model/blob/main/LICENSE)
1010
[![Downloads](https://static.pepy.tech/badge/power-grid-model)](https://pepy.tech/project/power-grid-model)
@@ -24,7 +24,7 @@ SPDX-License-Identifier: MPL-2.0
2424

2525
[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.8054429.svg)](https://zenodo.org/record/8054429)
2626

27-
[![Power Grid Model logo](https://github.com/PowerGridModel/.github/blob/main/artwork/svg/color.svg)](#) <!-- markdownlint-disable-line no-empty-links -->
27+
[![Power Grid Model logo](https://github.com/PowerGridModel/.github/blob/main/artwork/svg/color.svg)](#) <!-- markdownlint-disable-line no-empty-links line-length -->
2828

2929
# Power Grid Model
3030

@@ -37,11 +37,14 @@ Currently, it supports the following calculations:
3737
* Short Circuit
3838

3939
See the [power-grid-model documentation](https://power-grid-model.readthedocs.io/en/stable/) for more information.
40-
For various conversions to the power-grid-model, refer to the [power-grid-model-io](https://github.com/PowerGridModel/power-grid-model-io) repository.
41-
For an extended python interface to the the power-grid-model, refer to the [power-grid-model-ds](https://github.com/PowerGridModel/power-grid-model-ds) repository.
40+
For various conversions to the power-grid-model, refer to the
41+
[power-grid-model-io](https://github.com/PowerGridModel/power-grid-model-io) repository.
42+
For an extended python interface to the the power-grid-model, refer to the
43+
[power-grid-model-ds](https://github.com/PowerGridModel/power-grid-model-ds) repository.
4244

4345
```{note}
44-
Want to be updated on the latest news and releases? Subscribe to the Power Grid Model mailing list by sending an (empty) email to: [email protected]
46+
Want to be updated on the latest news and releases? Subscribe to the Power Grid Model mailing list by sending an (empty)
47+
4548
```
4649

4750
## Installation
@@ -64,34 +67,43 @@ conda install -c conda-forge power-grid-model
6467

6568
### Build and install from Source
6669

67-
To install the library from source, refer to the [Build Guide](https://power-grid-model.readthedocs.io/en/stable/advanced_documentation/build-guide.html).
70+
To install the library from source, refer to the
71+
[Build Guide](https://power-grid-model.readthedocs.io/en/stable/advanced_documentation/build-guide.html).
6872

6973
## Examples
7074

71-
Please refer to [Examples](https://github.com/PowerGridModel/power-grid-model-workshop/tree/main/examples) for more detailed examples for power flow and state estimation.
75+
Please refer to [Examples](https://github.com/PowerGridModel/power-grid-model-workshop/tree/main/examples) for more
76+
detailed examples for power flow and state estimation.
7277
Notebooks for validating the input data and exporting input/output data are also included.
7378

7479
## License
7580

76-
This project is licensed under the Mozilla Public License, version 2.0 - see [LICENSE](https://github.com/PowerGridModel/power-grid-model/blob/main/LICENSE) for details.
81+
This project is licensed under the Mozilla Public License, version 2.0 - see
82+
[LICENSE](https://github.com/PowerGridModel/power-grid-model/blob/main/LICENSE) for details.
7783

7884
## Licenses third-party libraries
7985

8086
This project includes third-party libraries,
8187
which are licensed under their own respective Open-Source licenses.
8288
SPDX-License-Identifier headers are used to show which license is applicable.
83-
The concerning license files can be found in the [LICENSES](https://github.com/PowerGridModel/power-grid-model/tree/main/LICENSES) directory.
89+
The concerning license files can be found in the
90+
[LICENSES](https://github.com/PowerGridModel/power-grid-model/tree/main/LICENSES) directory.
8491

8592
## Contributing
8693

87-
Please read [CODE_OF_CONDUCT](https://github.com/PowerGridModel/.github/blob/main/CODE_OF_CONDUCT.md), [CONTRIBUTING](https://github.com/PowerGridModel/.github/blob/main/CONTRIBUTING.md), [PROJECT GOVERNANCE](https://github.com/PowerGridModel/.github/blob/main/GOVERNANCE.md) and [RELEASE](https://github.com/PowerGridModel/.github/blob/main/RELEASE.md) for details on the process
88-
for submitting pull requests to us.
94+
Please read [CODE_OF_CONDUCT](https://github.com/PowerGridModel/.github/blob/main/CODE_OF_CONDUCT.md),
95+
[CONTRIBUTING](https://github.com/PowerGridModel/.github/blob/main/CONTRIBUTING.md),
96+
[PROJECT GOVERNANCE](https://github.com/PowerGridModel/.github/blob/main/GOVERNANCE.md) and
97+
[RELEASE](https://github.com/PowerGridModel/.github/blob/main/RELEASE.md) for details on the process for submitting pull
98+
requests to us.
8999

90-
Visit [Contribute](https://github.com/PowerGridModel/power-grid-model/contribute) for a list of good first issues in this repo.
100+
Visit [Contribute](https://github.com/PowerGridModel/power-grid-model/contribute) for a list of good first issues in
101+
this repo.
91102

92103
## Citations
93104

94-
If you are using Power Grid Model in your research work, please consider citing our library using the following references.
105+
If you are using Power Grid Model in your research work, please consider citing our library using the following
106+
references.
95107

96108
[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.8054429.svg)](https://zenodo.org/record/8054429)
97109

@@ -118,4 +130,5 @@ If you are using Power Grid Model in your research work, please consider citing
118130

119131
## Contact
120132

121-
Please read [SUPPORT](https://github.com/PowerGridModel/.github/blob/main/SUPPORT.md) for how to connect and get into contact with the Power Grid Model project.
133+
Please read [SUPPORT](https://github.com/PowerGridModel/.github/blob/main/SUPPORT.md) for how to connect and get into
134+
contact with the Power Grid Model project.

0 commit comments

Comments
 (0)