mirror of
https://github.com/nerfstudio-project/nerfstudio.git
synced 2026-11-17 05:14:15 +08:00
update quickstart + readme (#641)
* updated quickstart and readme * damn ctrl c on macs
This commit is contained in:
1 parent
5c3e1e8bb7
commit
5e56e7b229
7 files changed
+140
-174
No files matched your search
@@ -1,19 +1,20 @@
|
||||
# Contributing to nerfstudio workflow
|
||||
# Contributing
|
||||
|
||||
**We're excited to have you join the NerfStudio family!** :love_letter:
|
||||
**💝 We're excited to have you join the nerfstudio family 💝**
|
||||
|
||||
Below, we document the contribution pipeline and good-to-knows for when you're ready to submit a PR. If you have any questions at all, please don't hesitate to reach out to us. We'd love to hear from you!
|
||||
Below, we document the contribution pipeline and good-to-knows for when you're ready to submit a PR. If you have any questions at all, please don't hesitate to reach out to us on [Discord](https://discord.com/invite/NHGtYRAW). We'd love to hear from you!
|
||||
|
||||
The project is set up for development in VSCode, we recommend using it if you plan to contribute.
|
||||
|
||||
## TLDR
|
||||
## Overview
|
||||
Below are the various tooling features our team uses to maintain this codebase.
|
||||
|
||||
| | |
|
||||
| --------------- | ------ |
|
||||
| linter | Black |
|
||||
| Testing | PyTest |
|
||||
| Docs | Sphinx |
|
||||
| Docstring style | Google |
|
||||
| Tooling | Support |
|
||||
| --------------- | ------------- |
|
||||
| Linter | [Black](https://black.readthedocs.io/en/stable/) |
|
||||
| Testing | [PyTest](https://docs.pytest.org/en/7.1.x/) |
|
||||
| Docs | [Sphinx](https://www.sphinx-doc.org/en/master/) |
|
||||
| Docstring style | [Google](https://google.github.io/styleguide/pyguide.html) |
|
||||
|
||||
## Requirements
|
||||
|
||||
@@ -30,10 +31,10 @@ You may also need to install [pandoc](https://pandoc.org/). If you are using `co
|
||||
conda install -c conda-forge pandoc
|
||||
```
|
||||
|
||||
## Committing
|
||||
## Committing code
|
||||
|
||||
1. Make your modifications
|
||||
2. Perform local checks
|
||||
1. ✏️ Make your modifications
|
||||
2. ✅ Perform local checks
|
||||
|
||||
To ensure that you will be passing all tests and checks on github, you will need to run the following command:
|
||||
|
||||
@@ -41,18 +42,18 @@ conda install -c conda-forge pandoc
|
||||
ns-dev-test
|
||||
```
|
||||
|
||||
This will perform the following checks and actions:
|
||||
This will perform the following checks and actions:
|
||||
|
||||
- Black/ Linting style check: Ensure that the code is consistently and properly formatted.
|
||||
- Pytests: Runs pytests locally to make sure the logic of any added code does not break existing logic.
|
||||
- Documentation build: Builds the documentation locally to make sure none of the changes result in any warnings or errors in the docs.
|
||||
- Licensing: automatically adds licensing headers to the correct files.
|
||||
- Black/ Linting style check: Ensures code is consistently and properly formatted.
|
||||
- Pytests: Runs pytests locally to make sure added code does not break existing logic.
|
||||
- Documentation build: Builds docs locally. Ensures changes do not result in warnings/errors.
|
||||
- Licensing: Automatically adds licensing headers to the correct files.
|
||||
|
||||
In order to merge changes to the code base, all of these checks must be passing. If you pass these tests locally, you will likely pass on github servers as well (results in a green checkmark next to your commit).
|
||||
In order to merge changes to the code base, all of these checks must be passing. If you pass these tests locally, you will likely pass on github servers as well (results in a green checkmark next to your commit).
|
||||
|
||||
3. Open pull request
|
||||
3. 💌 Open pull request!
|
||||
|
||||
## Documentation
|
||||
## Maintaining documentation
|
||||
|
||||
### Building
|
||||
|
||||
@@ -64,7 +65,17 @@ python scripts/docs/build_docs.py
|
||||
|
||||
Rerun `make html` when documentation changes are made, `make clean` is necessary if the documentation structure changes.
|
||||
|
||||
### Notebooks
|
||||
### Auto build
|
||||
|
||||
As you change or add models/components, the auto-generated [Reference API](https://docs.nerf.studio/en/latest/reference/api/index.html) may change.
|
||||
If you want the code to build on save you can use [sphinx autobuild](https://github.com/executablebooks/sphinx-autobuild). If changes to the structure are made, the build files may be incorrect.
|
||||
|
||||
```bash
|
||||
pip install sphinx-autobuild
|
||||
sphinx-autobuild docs docs/_build/html
|
||||
```
|
||||
|
||||
### Adding notebooks
|
||||
|
||||
We support jupyter notbooks in our documentation. To improve the readability, the following custom tags can be added to the top of each code cell to hide or collapse the code.
|
||||
|
||||
@@ -73,12 +84,3 @@ We support jupyter notbooks in our documentation. To improve the readability, th
|
||||
| # HIDDEN | Hide code block and output |
|
||||
| # COLLAPSED | Collapse the code in a dropdown but show the results |
|
||||
| # OUTPUT_ONLY | Only show the cell's output |
|
||||
|
||||
### Auto build
|
||||
|
||||
If you want the code to build on save you can use [sphinx autobuild](https://github.com/executablebooks/sphinx-autobuild). If changes to the structure are made, the build files may be incorrect.
|
||||
|
||||
```bash
|
||||
pip install sphinx-autobuild
|
||||
sphinx-autobuild docs docs/_build/html
|
||||
```
|
||||
Reference in new issue
Block a user