|
3 | 3 |
|
4 | 4 | This document is meant to help guide decisions about the future of `DeepLabCut`, be it in terms of |
5 | 5 | whether to accept new functionality, changes to the styling of the code or graphical user interfaces (GUI), |
6 | | -or whether to take on new dependencies, when to break into other repos, among other things. It serves as a point of reference for core developers actively working on the project, and an introduction for |
| 6 | +or whether to take on new dependencies, when to break into other repos, among other things. It serves as a point of |
| 7 | +reference for core developers actively working on the project, and an introduction for |
7 | 8 | newcomers who want to learn a little more about where the project is going and what the team's |
8 | | -values are. You can also learn more about how the project is managed by looking at our [governance model](governance-model). |
| 9 | +values are. You can also learn more about how the project is managed by looking at our |
| 10 | +[governance model](governance-model). |
9 | 11 |
|
10 | 12 | ## Our founding principles |
11 | 13 |
|
12 | | -The founding DeepLabCut team came together around a shared vision for building the first open-source animal pose estimation framework |
13 | | -that is: |
| 14 | +The founding DeepLabCut team came together around a shared vision for building the first open-source animal pose |
| 15 | +estimation framework that is: |
14 | 16 |
|
15 | 17 | - user defined pose estimation - i.e. species or object agnostic. |
16 | 18 | - access to SOTA deep learning models that can be swiftly re-trained for customized applications |
17 | 19 | - fast (GPU-powered) |
18 | 20 | - scalable (project focused for ease of portability and sharability) |
19 | 21 |
|
20 | 22 |
|
21 | | -As the project has grown we've turned these original principles into the mission statement and set of values that we described below. |
| 23 | +As the project has grown we've turned these original principles into the mission statement and set of values that we |
| 24 | +described below. |
22 | 25 |
|
23 | 26 | ## Our mission |
24 | 27 |
|
25 | | -DeepLabCut aims to be **the animal pose software package for Python** and to **provide access to deep learning-based pose estimation for people to use in their daily work** without the need to be able to program in a deep learning framework. |
26 | | -We hope to accomplish this by: |
| 28 | +DeepLabCut aims to be **the animal pose software package for Python** and to **provide access to deep learning-based |
| 29 | +pose estimation for people to use in their daily work** without the need to be able to program in a deep learning |
| 30 | +framework. We hope to accomplish this by: |
27 | 31 |
|
28 | | -- being **easy to use and install**. We are careful in taking on new dependencies, sometimes making them optional, and aim support a fully (Python) packaged installation that works cross-platform. |
| 32 | +- being **easy to use and install**. We are careful in taking on new dependencies, sometimes making them optional, and |
| 33 | +aim support a fully (Python) packaged installation that works cross-platform. |
29 | 34 |
|
30 | | -- being **well-documented** with **comprehensive tutorials and examples**. All functions in our API have thorough docstrings clarifying expected inputs and outputs, and we maintain a separate [tutorials and information website](http://deeplabcut.org). |
| 35 | +- being **well-documented** with **comprehensive tutorials and examples**. All functions in our API have thorough |
| 36 | +docstrings clarifying expected inputs and outputs, and we maintain a separate |
| 37 | +[tutorials and information website](http://deeplabcut.org). |
31 | 38 |
|
32 | 39 | - providing **GUI access** to all critical functionality so DeepLabCut can be used by people without coding experience. |
33 | 40 |
|
34 | 41 | - being **interactive** and **highly performant** in order to support large data pipelines. |
35 | 42 |
|
36 | | -- providing a **consistent and stable API** to enable plugin developers to build on top of DeepLabCut without their code constantly breaking and to enable advanced users to build out sophisticated Python workflows, if needed. |
| 43 | +- providing a **consistent and stable API** to enable plugin developers to build on top of DeepLabCut without their |
| 44 | +code constantly breaking and to enable advanced users to build out sophisticated Python workflows, if needed. |
37 | 45 |
|
38 | | -- **ensuring correctness**. We strive for complete test coverage of both the code and GUI, with all code reviewed by a core developer before being included in the repository. |
| 46 | +- **ensuring correctness**. We strive for complete test coverage of both the code and GUI, with all code reviewed by a |
| 47 | +core developer before being included in the repository. |
39 | 48 |
|
40 | 49 | ## Our values |
41 | 50 |
|
42 | | -- We are **inclusive**. We welcome newcomers who are making their first contribution and strive to grow our most dedicated contributors into [core developers](https://github.com/orgs/DeepLabCut/teams/core-developers). We have a [Code of Conduct](https://github.com/DeepLabCut/DeepLabCut/CODE_OF_CONDUCT.md) to make DeepLabCut |
| 51 | +- We are **inclusive**. We welcome newcomers who are making their first contribution and strive to grow our most |
| 52 | +dedicated contributors into [core developers](https://github.com/orgs/DeepLabCut/teams/core-developers). |
| 53 | +We have a [Code of Conduct](https://github.com/DeepLabCut/DeepLabCut/blob/main/CODE_OF_CONDUCT.md) to make DeepLabCut |
43 | 54 | a welcoming place for all. |
44 | 55 |
|
45 | | -- We are **community-engaged**. We respond to feature requests and proposals on our [issue tracker](https://github.com/DeepLabCut/DeepLabCut/issues). |
| 56 | +- We are **community-engaged**. We respond to feature requests and proposals on our |
| 57 | +- [issue tracker](https://github.com/DeepLabCut/DeepLabCut/issues). |
46 | 58 |
|
47 | | -- We serve **scientific applications** primarily, over “consumer or commercial” pose estimation tools. This often means prioritizing core functionality support, and rejecting implementations of “flashy” features that have little scientific value. |
| 59 | +- We serve **scientific applications** primarily, over “consumer or commercial” pose estimation tools. This often means |
| 60 | +prioritizing core functionality support, and rejecting implementations of “flashy” features that have little |
| 61 | +scientific value. |
48 | 62 |
|
49 | | -- We are **domain agnostic** within the sciences. Functionality that is highly specific to particular scientific domains belongs in plugins, whereas functionality that cuts across many domains and is likely to be widely used belongs inside DeepLabCut. |
| 63 | +- We are **domain agnostic** within the sciences. Functionality that is highly specific to particular scientific |
| 64 | +domains belongs in plugins, whereas functionality that cuts across many domains and is likely to be widely used belongs |
| 65 | +inside DeepLabCut. |
50 | 66 |
|
51 | | -- We value **education and documentation**. All functions should have docstrings, preferably with examples, and major functionality should be explained in our [tutorials](http://deeplabcut.org). Core developers can take an active role in finishing documentation examples. |
| 67 | +- We value **education and documentation**. All functions should have docstrings, preferably with examples, and major |
| 68 | +functionality should be explained in our [tutorials](http://deeplabcut.org). Core developers can take an active role |
| 69 | +in finishing documentation examples. |
52 | 70 |
|
53 | 71 |
|
54 | 72 | ## Acknowledgements |
55 | 73 |
|
56 | | -We share a lot of our mission and values with [`napari`](https://napari.org/docs/developers/MISSION_AND_VALUES.html) and [`scikit-image`](https://scikit-image.org/docs/dev/values.html) and acknowledge the influence of their mission and values statements on this document. |
| 74 | +We share a lot of our mission and values with [`napari`](https://napari.org/stable/community/mission_and_values.html) |
| 75 | +and [`scikit-image`](https://scikit-image.org/docs/stable/about/values.html) and acknowledge the influence of their |
| 76 | +mission and values statements on this document. |
0 commit comments