Skip to content

Commit

Permalink
Fix: update for final page review
Browse files Browse the repository at this point in the history
  • Loading branch information
lwasser committed Jan 16, 2024
1 parent 596bed9 commit 4078d48
Show file tree
Hide file tree
Showing 8 changed files with 32 additions and 12 deletions.
File renamed without changes.
11 changes: 11 additions & 0 deletions ci-data/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
# Continuous Integration and Data for your package


:::{toctree}
:hidden:
:caption: CI & Data


What is CI? <ci.md>
Data <data.md>
:::
1 change: 0 additions & 1 deletion ci-tests-data/data.md

This file was deleted.

2 changes: 1 addition & 1 deletion conf.py
Original file line number Diff line number Diff line change
Expand Up @@ -97,7 +97,7 @@
"image_light": "logo-light-mode.png",
"alt_text": "pyOpenSci Python Package Guide. The pyOpenSci logo is a purple flower with pyOpenSci under it. The o in open sci is the center of the flower",
},
"header_links_before_dropdown": 4,
"header_links_before_dropdown": 5,
"use_edit_page_button": True,
"show_nav_level": 2,
"navigation_depth": 3,
Expand Down
23 changes: 16 additions & 7 deletions index.md
Original file line number Diff line number Diff line change
Expand Up @@ -214,26 +214,35 @@ Tutorials <tutorials/intro>
```


```{toctree}
:::{toctree}
:hidden:
:caption: Documentation

Documentation <documentation/index>

```
:::

```{toctree}
:::{toctree}
:hidden:
:caption: Packaging
:caption: Build & Publish

Packaging <package-structure-code/intro>

```
:::

```{toctree}
:::{toctree}
:hidden:
:caption: Testing

Tests <tests/index>

```
:::


:::{toctree}
:hidden:
:caption: CI & Data

CI & Data <ci-data/index>

:::
4 changes: 2 additions & 2 deletions package-structure-code/intro.md
Original file line number Diff line number Diff line change
Expand Up @@ -162,7 +162,7 @@ if you are looking for pyOpenSci's Python package review requirements!

:::{toctree}
:hidden:
:caption: Package structure & code style
:caption: Create & Build Your Package

Intro <self>

Expand All @@ -176,7 +176,7 @@ Complex Builds <complex-python-package-builds>

:::{toctree}
:hidden:
:caption: Publishing a package
:caption: Publish your package

Publish with Conda / PyPI <publish-python-package-pypi-conda>
Package versions <python-package-versions>
Expand Down
2 changes: 1 addition & 1 deletion ci-tests-data/code-cov.md → tests/code-cov.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# Code coverage
# Code coverage for your Python package test suite

Code coverage is the amount of your package's codebase that is run as a part of running your project's tests. A good rule of thumb is to ensure that every line of your code is run at least once during testing. However, note that good code coverage does not guarantee that your package is well-tested. For example, you may run all of your lines of code, but not account for many edge-cases that users may have. Ultimately, you should think carefully about the way your package will be used, and decide whether your tests adequately cover all of that usage.

Expand Down
1 change: 1 addition & 0 deletions tests/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -79,4 +79,5 @@ Write tests <write-tests>
Test types <test-types>
Run tests locally <run-tests>
Run tests online (using CI) <tests-ci>
Code coverage <code-cov>
```

0 comments on commit 4078d48

Please sign in to comment.