Are you sure you want to delete this access key?
Before anything else, please install the git hooks that run automatic scripts during each commit and merge to strip the notebooks of superfluous metadata (and avoid merge conflicts). After cloning the repository, run the following command inside it:
nbdev_install_git_hooks
Please follow the below guidelines for creating and submitting PRs to this repo
- [optional] `pip install -e .` - do this if your nbs are not located in the project's root folder, e.g. if they are in reformer_fastai/nbs
- [optional `gh repo fork --remote` - for the repo if you are not a collaborator
- `nbdev_install_git_hooks`
- `git checkout -b add-my-feature` - create a new branch
- **Make your changes to notebook**
- `nbdev_build_lib` - Build the library
- `nbdev_build_docs` - Build the docs (see note below on docs)
- [optional] To run the same checks that the Continuous Integration on Github will run:
- `nbdev_read_nbs`
- `nbdev_clean_nbs`
- `nbdev_diff_nbs`
- `nbdev_test_nbs`
- `git commit -am "just testing"` - commit your changes
- `git push -u origin HEAD` if its your first push from this repo/fork, `git push` after that
- `gh pr create -f` - Create your PR
- `git pull upstream master` - Keep up to date with the master branch
- `git checkout master`
- `git branch -d add-my-feature` - Once PR merged, delete your branch
- Make sure tests don't take too long, testing time quickly adds up!
- Make sure your tests don't produce new notebooks
- For experiments and other similar notebooks use the ``#slow` flag for a cell or `#all_slow flag` for the remainder of the notebook to not test those cells.
- Note that if you add a new notebook it won't be added to the docs automatically any longer. The .html file has to be added to our custom docs/sidebar.json
- This is because we are using a custom sidebar, see here for more: https://nbdev.fast.ai/export2html.html#Sidebar
- Edit index.ipynb to edit the README.md and your project's homepage
- To checkout an existing PR locally: gh pr checkout pr_number. If one adds commits to the branch and pushes those, the PR is also updated.
Press p or to see the previous file or, n or to see the next file
Are you sure you want to delete this access key?
Are you sure you want to delete this access key?
Are you sure you want to delete this access key?
Are you sure you want to delete this access key?