Skip to content

Bring incremental writing, mail and literate programming to Emacs and Org-mode

Notifications You must be signed in to change notification settings

nanjigen/org-incremental

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

88 Commits
 
 
 
 
 
 

Repository files navigation

org-incremental

This package is designed to bring incremental writing, incremental mail processing and incremental literate programming capabilities to org-mode and Emacs.

It works with org-ql in order to find and generate lists of included files.

Key functions we would need:

  • A-factor
  • Priority
  • Postpone/Reschedule (Intra- and inter-day)
  • Dismissing (of files and sub-headers)
  • Mercy
  • TODO keywords: (“to write”, “to expand”, “to rewrite”, “to review”, “finished”)
  • Statistical analysis to chart the progress through the writing material (magit and calendar)
  • Outstanding headline sorting by priority to match circadian cycles (high for high alertness and low for end of day)

Features:

  • Incremental literate programming with org-mode and SM’s algorithm!
  • Incremental writing of email with tools like ~mu4e~!
  • Deadline awareness (modify priority/a-factor/scheduled date based on distance to deadline)

Overview

PROJECT Why incremental writing?

Incremental writing is a concept co-developed by Piotr Wozniak and users of Supermemo employing the topic spacing feature to break writing projects into sub-chapters, as a form of creative elaboration.

Woz writes:

(Texts)… may be bloated and repetitive, however, with incremental reading, they can be prioritized in a rational way. Incremental writing leaves the texts highly granular and the flow of thought is jagged, however … this is an advantage as all individual articles and subarticles carry sufficient local context to be read independently.

The above relates to the granularity of articles written using IW lending itself to IR as extracts tend to be discrete. In the context of incremental literate programming, I believe the contextualisation provided by prose encapsulated in subheadings offer these same advantages while also then allowing us to use the spacing effect over blocks of code. Org-mode’s narrowing and widening features further help to constrain or expand context in the flow of IW.

Read Incremental writing page

https://www.masterhowtolearn.com/2020-06-09-incremental-writing-no-more-writer-block/ https://help.supermemo.org/wiki/Incremental_learning#Incremental_writing https://www.masterhowtolearn.com/2020-08-09-the-magic-behind-incremental-writing-spacing-and-interleaving/

Getting started

Example configuration:

(use-package org-incremental
  :config
  (setq org-incremental-todo-keywords '("NEXT")))

About

Bring incremental writing, mail and literate programming to Emacs and Org-mode

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published