Skip to content

Commit 3a99d41

Browse files
committed
Update README
1 parent 115dd54 commit 3a99d41

1 file changed

Lines changed: 68 additions & 0 deletions

File tree

README.md

Lines changed: 68 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,66 @@
1+
<!--- --8<-- [start:description] -->
12
# mkdocstrings-python-accessors
23

4+
Support for documenting accessors with mkdocstrings.
5+
6+
**Key info :**
7+
[![Docs](https://readthedocs.org/projects/mkdocstrings-python-accessors/badge/?version=latest)](https://mkdocstrings-python-accessors.readthedocs.io)
8+
[![Main branch: supported Python versions](https://img.shields.io/python/required-version-toml?tomlFilePath=https%3A%2F%2Fraw.githubusercontent.com%2Fclimate-resource%2Fmkdocstrings-python-accessors%2Fmain%2Fpyproject.toml)](https://github.com/climate-resource/mkdocstrings-python-accessors/blob/main/pyproject.toml)
9+
[![Licence](https://img.shields.io/pypi/l/mkdocstrings-python-accessors?label=licence)](https://github.com/climate-resource/mkdocstrings-python-accessors/blob/main/LICENCE)
10+
11+
**PyPI :**
12+
[![PyPI](https://img.shields.io/pypi/v/mkdocstrings-python-accessors.svg)](https://pypi.org/project/mkdocstrings-python-accessors/)
13+
[![PyPI install](https://github.com/climate-resource/mkdocstrings-python-accessors/actions/workflows/install-pypi.yaml/badge.svg?branch=main)](https://github.com/climate-resource/mkdocstrings-python-accessors/actions/workflows/install-pypi.yaml)
14+
15+
**Tests :**
16+
[![CI](https://github.com/climate-resource/mkdocstrings-python-accessors/actions/workflows/ci.yaml/badge.svg?branch=main)](https://github.com/climate-resource/mkdocstrings-python-accessors/actions/workflows/ci.yaml)
17+
[![Coverage](https://codecov.io/gh/climate-resource/mkdocstrings-python-accessors/branch/main/graph/badge.svg)](https://codecov.io/gh/climate-resource/mkdocstrings-python-accessors)
18+
19+
**Other info :**
20+
[![Last Commit](https://img.shields.io/github/last-commit/climate-resource/mkdocstrings-python-accessors.svg)](https://github.com/climate-resource/mkdocstrings-python-accessors/commits/main)
21+
[![Contributors](https://img.shields.io/github/contributors/climate-resource/mkdocstrings-python-accessors.svg)](https://github.com/climate-resource/mkdocstrings-python-accessors/graphs/contributors)
22+
## Status
23+
24+
<!---
25+
26+
We recommend having a status line in your repo
27+
to tell anyone who stumbles on your repository where you're up to.
28+
Some suggested options:
29+
30+
- prototype: the project is just starting up and the code is all prototype
31+
- development: the project is actively being worked on
32+
- finished: the project has achieved what it wanted
33+
and is no longer being worked on, we won't reply to any issues
34+
- dormant: the project is no longer worked on
35+
but we might come back to it,
36+
if you have questions, feel free to raise an issue
37+
- abandoned: this project is no longer worked on
38+
and we won't reply to any issues
39+
-->
40+
41+
- development: the project is actively being worked on
42+
43+
<!--- --8<-- [end:description] -->
44+
45+
## Installation
46+
47+
<!--- --8<-- [start:installation] -->
48+
49+
The latest version of mkdocstrings-python-accessors can be installed with
50+
51+
=== "pip"
52+
```sh
53+
pip install mkdocstrings-python-accessors
54+
```
55+
56+
### For developers
57+
58+
This package isn't maintained in our usual way.
59+
It's super thin and not subject to any of our usual tests etc.
60+
Hence there are no installation instructions here.
61+
62+
<!--- --8<-- [end:installation] -->
63+
364
Python handler for [mkdocstrings](https://github.com/mkdocstrings/mkdocstrings)
465
supporting documentation of accessors.
566
Takes inspiration from [sphinx-autosummary-accessors](https://github.com/xarray-contrib/sphinx-autosummary-accessors).
@@ -66,3 +127,10 @@ to modify the appearance as you wish.
66127
show_root_full_path: false
67128
show_root_heading: true
68129
```
130+
131+
## Original template
132+
133+
This project was generated from this template:
134+
[copier core python repository](https://gitlab.com/znicholls/copier-core-python-repository).
135+
[copier](https://copier.readthedocs.io/en/stable/) is used to manage and
136+
distribute this template.

0 commit comments

Comments
 (0)