Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Missing section on transferring existing project to the template #34

Open
brynpickering opened this issue Jun 19, 2024 · 0 comments
Open
Labels
documentation Improvements or additions to documentation

Comments

@brynpickering
Copy link
Collaborator

Description

There are instances where we want to align an existing, relatively mature project to the template. This requires some careful transplanting work to which we'd benefit from documenting an approach.

E.g.,

  1. Create a dummy local repo in some other place on your device using the template tutorial steps.
  2. Copy across the parts of the "clean" repo one by one, aligning as you go.
  3. Likely start by moving the source code into one place (src/[module-name]), then the test folder, then the requirements directory and pyproject.toml (update requirements/base.yaml to include your project requirements). Hopefully that will be enough to start running tests to make sure everything still works.
  4. Move docs/ and mkdocs.yml to start re-constructing the docs.
  5. Any scripts with if __name__ == "__main__" calls should be in src/[module-name]/cli.py as command-line interface commands.
  6. Any example Jupyter Notebook scripts should be in examples.

Related links

Version

v0.2.0

Proposed change

No response

@brynpickering brynpickering added the documentation Improvements or additions to documentation label Jun 19, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

No branches or pull requests

1 participant