Track when you have done a review in org mode.
Tasks typically have Scheduled and Deadline time stamps, which define when the task has to be done. Org-review lets you attach an additional review time stamp to a task, which can be used to schedule a review of the task.
org-review.elto a path known to emacs.
- Add the following to your emacs configuration file.
- Configure an agenda view that shows the projects that are available
for review. You could for instance add the following in your emacs
(setq org-agenda-custom-commands '(("R" "Review projects" tags-todo "-CANCELLED/" ((org-agenda-overriding-header "Reviews Scheduled") (org-agenda-skip-function 'org-review-agenda-skip) (org-agenda-cmp-user-defined 'org-review-compare) (org-agenda-sorting-strategy '(user-defined-down))))))
- If you want to mark a project reviewed when you are in an agenda
view, you can do so by assigning a key binding for
(add-hook 'org-agenda-mode-hook (lambda () (local-set-key (kbd "C-c C-r") 'org-review-insert-last-review)))
How it works
Entries will be scheduled for review if their
LAST_REVIEW property is set. The next review date is
NEXT_REVIEW date, if it is present, otherwise it is computed
LAST_REVIEW property and the
REVIEW_DELAY period, such
REVIEW_DELAY is absent, a default period is used. Note
LAST_REVIEW property is not considered as inherited,
REVIEW_DELAY is, allowing to set it for whole subtrees.
To set these properties, you may use the
C-c C-x p by default). For the
org-review-insert-next-review is provided, that prompts
for a date and inserts it.
Checking of review dates is done through an agenda view, using
org-review-agenda-skip skipping function. This function is based
org-review-toreview-p, that returns
nil if no review is
necessary (no review planned or it happened recently), otherwise it
returns the date the review was first necessary (
LAST_REVIEW + REVIEW_DELAY, if it is in the past).
To mark an entry as reviewed, use the
org-review-insert-last-review to set the
to the current date. If
org-review-sets-next-date is set (which is
the default), this function also computes the date of the next review
and inserts it as
Several options, such as the format of the time stamps, may be set
customize-group command for the