Add details to readme
This commit is contained in:
parent
44dbe00187
commit
0eb171df9b
1 changed files with 24 additions and 2 deletions
26
README.md
26
README.md
|
@ -1,5 +1,27 @@
|
||||||
# todoist-github
|
# Todoist GitHub
|
||||||
|
|
||||||
![](https://github.com/RealOrangeOne/todoist-github/workflows/Build/badge.svg)
|
![](https://github.com/RealOrangeOne/todoist-github/workflows/Build/badge.svg)
|
||||||
|
|
||||||
Import assigned issues and PRs into Todoist
|
Import assigned issues and PRs into Todoist.
|
||||||
|
|
||||||
|
A docker container is available for easy usage: https://hub.docker.com/r/theorangeone/todoist-github
|
||||||
|
|
||||||
|
## Requirements
|
||||||
|
|
||||||
|
- `requirements.txt` installed in your environment
|
||||||
|
- `$TODOIST_TOKEN`
|
||||||
|
- `$GITHUB_TOKEN` (Requires at least `public_repo`, `repo` required for access to private repositories)
|
||||||
|
|
||||||
|
## Usage
|
||||||
|
|
||||||
|
Run `python3 -m todoist_github` to run once. `--interval` can be used to provide the number of seconds between automated updates.
|
||||||
|
|
||||||
|
## Task Details
|
||||||
|
|
||||||
|
Task names are built using the task link and title, and are updated automatically on rename.
|
||||||
|
|
||||||
|
Tasks are added to projects based on the repository organisation / owner or repository name. If specially named projects exist as children of these, they're used instead. If no project is found, `$DEFAULT_TODOIST_PROJECT_NAME` can be used, else no project is assigned.
|
||||||
|
|
||||||
|
Task due dates are based off their milestone.
|
||||||
|
|
||||||
|
Once an issue is closed / PR merged, the task is completed. If you're unassigned, the issue is deleted.
|
||||||
|
|
Reference in a new issue