Skip to content

Commit 61b7f8b

Browse files
authored
footer copyright fix, sidenav tweaks, icon url for pypi (#30)
- removed dupe of copyright config for docs footer - added help and support to docs nav - edited better url for repo icon and pypi - misc text fixes
1 parent 99c9ec1 commit 61b7f8b

File tree

5 files changed

+34
-23
lines changed

5 files changed

+34
-23
lines changed

README.md

+5-5
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ See the License for the specific language governing permissions and
1414
limitations under the License.
1515
-->
1616

17-
# ![icon for SparseZoo](https://github.com/neuralmagic/sparsezoo/blob/main/docs/icon-sparsezoo.png) SparseZoo
17+
# ![icon for SparseZoo](https://raw.githubusercontent.com/neuralmagic/sparsezoo/main/docs/source/icon-sparsezoo.png) SparseZoo
1818

1919
### Neural network model repository for highly sparse models and optimization recipes
2020

@@ -23,7 +23,7 @@ limitations under the License.
2323
<img alt="GitHub" src="https://img.shields.io/github/license/neuralmagic/comingsoon.svg?color=purple&style=for-the-badge" height=25>
2424
</a>
2525
<a href="https://docs.neuralmagic.com/sparsezoo/index.html">
26-
<img alt="Documentation" src="https://img.shields.io/website/http/neuralmagic.com/sparsezoo/index.html.svg?down_color=red&down_message=offline&up_message=online&style=for-the-badge" height=25>
26+
<img alt="Documentation" src="https://img.shields.io/website/http/docs.neuralmagic.com/sparsezoo/index.html.svg?down_color=red&down_message=offline&up_message=online&style=for-the-badge" height=25>
2727
</a>
2828
<a href="https://github.com/neuralmagic/sparsezoo/releases">
2929
<img alt="GitHub release" src="https://img.shields.io/github/release/neuralmagic/sparsezoo.svg?style=for-the-badge" height=25>
@@ -205,13 +205,13 @@ Install with pip using:
205205
pip install sparsezoo
206206
```
207207

208-
Then if you would like to explore any of the [scripts](https://github.com/neuralmagic/sparsezoo/blob/main/scripts/), [notebooks](https://github.com/neuralmagic/sparsezoo/blob/main/notebooks/), or [examples](https://github.com/neuralmagic/sparsezoo/blob/main/examples/)
208+
Then if you would like to explore any of the [scripts](https://github.com/neuralmagic/sparsezoo/blob/main/scripts/) or [notebooks](https://github.com/neuralmagic/sparsezoo/blob/main/notebooks/)
209209
clone the repository and install any additional dependencies as required.
210210

211211
## Available Models and Recipes
212212

213213
A number of pre-trained baseline and optimized models across domains and sub domains are available and constantly being added.
214-
For an up to date list, please consult the [available models listing](https://github.com/neuralmagic/sparsezoo/blob/main/docs/available-models.md).
214+
For an up to date list, please consult the [available models listing](https://github.com/neuralmagic/sparsezoo/blob/main/docs/source/models.md).
215215

216216
## Resources and Learning More
217217

@@ -223,7 +223,7 @@ For an up to date list, please consult the [available models listing](https://gi
223223

224224
## Contributing
225225

226-
We appreciate contributions to the code, examples, and documentation as well as bug reports and feature requests![Learn how here](https://github.com/neuralmagic/sparsezoo/blob/main/CONTRIBUTING.md).
226+
We appreciate contributions to the code, examples, and documentation as well as bug reports and feature requests! [Learn how here](https://github.com/neuralmagic/sparsezoo/blob/main/CONTRIBUTING.md).
227227

228228
## Join the Community
229229

docs/source/conf.py

+5-5
Original file line numberDiff line numberDiff line change
@@ -18,9 +18,9 @@
1818

1919
# -- Project information -----------------------------------------------------
2020

21-
project = "Sparse Zoo"
21+
project = "SparseZoo"
2222
copyright = (
23-
"Copyright (c) 2021 - present / Neuralmagic, Inc. All Rights Reserved. "
23+
"2021 - present / Neuralmagic, Inc. All Rights Reserved. "
2424
'Licensed under the Apache License, Version 2.0 (the "License")'
2525
)
2626
author = "Neural Magic"
@@ -122,14 +122,14 @@
122122
# (source start file, target name, title,
123123
# author, documentclass [howto, manual, or own class]).
124124
latex_documents = [
125-
(master_doc, "sparsezoo.tex", "Sparse Zoo Documentation", [author], "manual",),
125+
(master_doc, "sparsezoo.tex", "SparseZoo Documentation", [author], "manual",),
126126
]
127127

128128
# -- Options for manual page output ------------------------------------------
129129

130130
# One entry per manual page. List of tuples
131131
# (source start file, name, description, authors, manual section).
132-
man_pages = [(master_doc, "sparsezoo", "Sparse Zoo Documentation", [author], 1)]
132+
man_pages = [(master_doc, "sparsezoo", "SparseZoo Documentation", [author], 1)]
133133

134134

135135
# -- Options for Texinfo output ----------------------------------------------
@@ -141,7 +141,7 @@
141141
(
142142
master_doc,
143143
"sparsezoo",
144-
"Sparse Zoo Documentation",
144+
"SparseZoo Documentation",
145145
author,
146146
"sparsezoo",
147147
(

docs/source/index.rst

+12-5
Original file line numberDiff line numberDiff line change
@@ -17,21 +17,21 @@
1717
SparseZoo |version|
1818
===================
1919

20-
Neural network model repository for highly sparse models and optimization recipes.
20+
Neural network model repository for highly sparse models and optimization recipes
2121

2222
.. raw:: html
2323

2424
<div style="margin-bottom:16px;">
25-
<a href="https://github.com/neuralmagic/sparsezoo/blob/master/LICENSE">
25+
<a href="https://github.com/neuralmagic/sparsezoo/blob/main/LICENSE">
2626
<img alt="GitHub" src="https://img.shields.io/github/license/neuralmagic/sparsezoo.svg?color=purple&style=for-the-badge" height=25 style="margin-bottom:4px;">
2727
</a>
2828
<a href="https://docs.neuralmagic.com/sparsezoo/index.html">
29-
<img alt="Documentation" src="https://img.shields.io/website/http/neuralmagic.com/sparsezoo/index.html.svg?down_color=red&down_message=offline&up_message=online&style=for-the-badge" height=25 style="margin-bottom:4px;">
29+
<img alt="Documentation" src="https://img.shields.io/website/http/docs.neuralmagic.com/sparsezoo/index.html.svg?down_color=red&down_message=offline&up_message=online&style=for-the-badge" height=25 style="margin-bottom:4px;">
3030
</a>
3131
<a href="https://github.com/neuralmagic/sparsezoo/releases">
3232
<img alt="GitHub release" src="https://img.shields.io/github/release/neuralmagic/sparsezoo.svg?style=for-the-badge" height=25 style="margin-bottom:4px;">
3333
</a>
34-
<a href="https://github.com/neuralmagic.com/sparsezoo/blob/master/CODE_OF_CONDUCT.md">
34+
<a href="https://github.com/neuralmagic.com/sparsezoo/blob/main/CODE_OF_CONDUCT.md">
3535
<img alt="Contributor Covenant" src="https://img.shields.io/badge/Contributor%20Covenant-v2.0%20adopted-ff69b4.svg?color=yellow&style=for-the-badge" height=25 style="margin-bottom:4px;">
3636
</a>
3737
<a href="https://www.youtube.com/channel/UCo8dO_WMGYbWCRnj_Dxr4EA">
@@ -77,7 +77,6 @@ Related Products
7777
Resources and Learning More
7878
===========================
7979

80-
- `SparseZoo Documentation <https://docs.neuralmagic.com/sparsezoo/ />`_
8180
- `SparseML Documentation <https://docs.neuralmagic.com/sparseml/ />`_
8281
- `Sparsify Documentation <https://docs.neuralmagic.com/sparsify/ />`_
8382
- `DeepSparse Documentation <https://docs.neuralmagic.com/deepsparse/ />`_
@@ -109,3 +108,11 @@ Additionally, more information can be found via
109108
:caption: API
110109

111110
api/sparsezoo
111+
112+
.. toctree::
113+
:maxdepth: 2
114+
:caption: Help and Support
115+
116+
`Bugs, Feature Requests <https://github.com/neuralmagic/sparsezoo/discussions>`_
117+
`Support, General Q&A <https://github.com/neuralmagic/sparsezoo/issues>`_
118+

docs/source/installation.md

+2-6
Original file line numberDiff line numberDiff line change
@@ -17,16 +17,12 @@ limitations under the License.
1717
### Installation
1818

1919
This repository is tested on Python 3.6+, and Linux/Debian systems.
20-
It is recommended to install in a [virtual environment](https://docs.python.org/3/library/venv.html)
21-
to keep your system in order.
20+
It is recommended to install in a [virtual environment](https://docs.python.org/3/library/venv.html) to keep your system in order.
2221

2322
Install with pip using:
2423

2524
```bash
2625
pip install sparsezoo
2726
```
2827

29-
Then if you would like to explore any of the [scripts](https://github.com/neuralmagic/sparsezoo/tree/main/scripts),
30-
[notebooks](https://github.com/neuralmagic/sparsezoo/tree/main/notebooks),
31-
or [examples](https://github.com/neuralmagic/sparsezoo/tree/main/examples)
32-
clone the repository and install any additional dependencies as required.
28+
Then if you would like to explore any of the [scripts](https://github.com/neuralmagic/sparsezoo/tree/main/scripts) or [notebooks](https://github.com/neuralmagic/sparsezoo/tree/main/notebooks) clone the repository and install any additional dependencies as required.

docs/source/quicktour.md

+10-2
Original file line numberDiff line numberDiff line change
@@ -56,6 +56,7 @@ The Python APIs respect this format enabling you to search and download models.
5656
Some code examples are given below.
5757

5858
#### Searching the Zoo
59+
5960
```python
6061
from sparsezoo import Zoo
6162

@@ -64,6 +65,7 @@ print(models)
6465
```
6566

6667
#### Common Models
68+
6769
```python
6870
from sparsezoo.models.classification import resnet_50
6971

@@ -74,6 +76,7 @@ print(model.onnx_file.downloaded_path())
7476
```
7577

7678
#### Searching Optimized Versions
79+
7780
```python
7881
from sparsezoo import Zoo
7982
from sparsezoo.models.classification import resnet_50
@@ -89,8 +92,7 @@ print(optimized_models)
8992
In addition to the Python APIs, a console script entry point is installed with the package `sparsezoo`.
9093
This enables easy interaction straight from your console/terminal.
9194
Note, for some environments the console scripts cannot install properly.
92-
If this happens for your system and the sparsezoo command is not available,
93-
`scripts/sparsezoo.py` may be used in its place.
95+
If this happens for your system and the sparsezoo command is not available, `scripts/sparsezoo.py` may be used in its place.
9496

9597
```shell script
9698
sparsezoo -h
@@ -99,29 +101,34 @@ sparsezoo -h
99101
#### Searching
100102

101103
Search command help
104+
102105
```shell script
103106
sparsezoo search -h
104107
```
105108

106109
<br>Searching for all classification models in the computer vision domain
110+
107111
```shell script
108112
sparsezoo search --domain cv --sub-domain classification \
109113
--architecture resnet_v1 --sub-architecture 50
110114
```
111115

112116
<br>Searching for all ResNet-50 models
117+
113118
```shell script
114119
sparsezoo search --domain cv --sub-domain classification
115120
```
116121

117122
#### Downloading
118123

119124
Download command help
125+
120126
```shell script
121127
sparsezoo download -h
122128
```
123129

124130
<br>Download ResNet-50 Model
131+
125132
```shell script
126133
sparsezoo download --domain cv --sub-domain classification \
127134
--architecture resnet_v1 --sub-architecture 50 \
@@ -130,6 +137,7 @@ sparsezoo download --domain cv --sub-domain classification \
130137
```
131138

132139
<br>Download pruned and quantized ResNet-50 Model
140+
133141
```shell script
134142
sparsezoo download --domain cv --sub-domain classification \
135143
--architecture resnet_v1 --sub-architecture 50 \

0 commit comments

Comments
 (0)