org-tutorials/org-effectiveness.org

   1 #+OPTIONS:    H:3 num:nil toc:t \n:nil ::t |:t ^:t -:t f:t *:t tex:t d:(HIDE) tags:not-in-toc
   2 #+STARTUP:    align fold nodlcheck hidestars oddeven lognotestate
   3 #+SEQ_TODO:   TODO(t) INPROGRESS(i) WAITING(w@) | DONE(d) CANCELED(c@)
   4 #+TAGS:       Write(w) Update(u) Fix(f) Check(c)
   5 #+TITLE: Org Effectiveness Tutorial
   6 #+AUTHOR: David Arroyo Menéndez
   7 #+EMAIL: davidam@es.gnu.org
   8 #+LANGUAGE:   en
   9 #+PRIORITIES: A C B
  10 #+CATEGORY:   worg-tutorial
  11
  12 # This file is the default header for new Org files in Worg.  Feel free
  13 # to tailor it to your needs.
  14 #+STARTUP:    align fold nodlcheck hidestars indent
  15
  16 [[file:index.org][{Back to Worg's index}]]
  17
  18 * Introduction
  19
  20 In the Personal Software Process, we attend to the tasks in the
  21 estimated time, but few times we attend to effectiveness,
  22 understanding by effectiveness, the tasks done comparising the
  23 proposed tasks.
  24
  25 The formal educative process try evaluate with respect to solve exams,
  26 that is, quizes or another academic tests and some times training
  27 exercises, although, few times the student knows if execute your own
  28 personal objectives: what is the reason because I've started to study
  29 something if I've learn it or don't. Finally, someone knows if learn
  30 things because has been able to make. The idea presented in this
  31 tutorial is a software to everyone can be evaluted to himself in
  32 function to his own personal objectives. We can say that measure the
  33 effectiveness is know if we are honest whith ourselves.
  34
  35 * Installation
  36
  37 Currently, org-effectiveness.el is stored in contrib, you can download worg with:
  38 #+BEGIN_SRC bash
  39 $ cd ~
  40 $ mkdir git
  41 $ cd git
  42 $ git clone https://code.orgmode.org/bzg/org-mode.git
  43 #+END_SRC
  44
  45 You can find org-effectiveness.el in ~/git/org-mode/contrib/lisp
  46
  47 So, you can add the next line (or similar) in your .emacs
  48 #+BEGIN_SRC lisp
  49 (load "~/git/org-mode/contrib/lisp/org-effectiveness.el")
  50 #+END_SRC
  51
  52 If you want use the plot feature, you must install gnuplot, for instance in debian, you can do:
  53 #+BEGIN_SRC bash
  54 $ apt-get install gnuplot
  55 #+END_SRC
  56
  57 * Counting outlines
  58
  59 To measure the effectiveness we can count tasks done and tasks
  60 cancelled, but perhaps you want count the tasks pending or tasks in
  61 another state, so we've built some functions to it.
  62
  63 With org-effectiveness-count-keyword, we can count an outline in an
  64 state (keyword) given. For example:
  65
  66 #+BEGIN_SRC lisp
  67 M-x org-effectiveness-count-keyword TODO
  68 #+END_SRC
  69
  70 Usually, anyone will be using the next states: TODO, CANCELED and DONE
  71 at least, so we can use
  72
  73 #+BEGIN_SRC lisp
  74 M-x org-effectiveness-count-todo
  75 M-x org-effectiveness-count-done
  76 M-x org-effectiveness-count-canceled
  77 #+END_SRC
  78
  79 * Effectiveness
  80
  81 The calculus that I propose to know if someones is effectiveness is
  82 very simple is enough dividing the number of tasks DONE with the
  83 CANCELED. So, we can know the total effectiveness in the current
  84 buffer with:
  85
  86 #+BEGIN_SRC lisp
  87 M-x org-effectiveness
  88 #+END_SRC
  89
  90 We can know, the effectiveness in a specific date with
  91
  92 #+BEGIN_SRC lisp
  93 M-x org-effectiveness-in-date
  94 #+END_SRC
  95
  96 Writing the date in the format YYYY-MM-DD.
  97
  98
  99 * Productivity
 100
 101 Make an only task in one month is not very difficult, if you only want
 102 make one task is ok, you are 100% effectiveness, but the people is
 103 ambitious, the companies want reach many task, without cancel anything.
 104
 105 We can consider that measure our productivity is only measure the
 106 tasks done in a period of time (see [[ref1][1]]). For example, in a month:
 107
 108 #+BEGIN_SRC lisp
 109 M-x org-effectiveness-dones-in-date
 110 #+END_SRC
 111
 112 * Deploying graphs
 113
 114 We can deploy a *gnuplot graph* to know the effectiveness in the current
 115 buffer by months with:
 116
 117 #+BEGIN_SRC lisp
 118 M-x org-effectiveness-plot
 119 #+END_SRC
 120
 121 We can deploy an *ascii graph* to know the effectiveness in the current
 122 buffer by months with:
 123
 124 #+BEGIN_SRC lisp
 125 M-x org-effectiveness-plot-ascii
 126 #+END_SRC
 127
 128 * References
 129
 130 1. <<ref1>> Barry W. Boehm, TRW (1987) Improving Software Productivity
 131
 132
 133 * License
 134
 135 This document is under a [[http://creativecommons.org/licenses/by/3.0/deed][Creative Commons Attribution Unported 3.0]]
 136
 137 [[http://creativecommons.org/licenses/by/3.0/deed][file:http://i.creativecommons.org/l/by/3.0/80x15.png]]