From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp0 ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id AD9iInhVxWDgPAEAgWs5BA (envelope-from ) for ; Sun, 13 Jun 2021 02:46:48 +0200 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp0 with LMTPS id ULHMHXhVxWCWOwAA1q6Kng (envelope-from ) for ; Sun, 13 Jun 2021 00:46:48 +0000 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id B3129C880 for ; Sun, 13 Jun 2021 02:46:47 +0200 (CEST) Received: from localhost ([::1]:46254 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lsEGz-0004BL-EG for larch@yhetil.org; Sat, 12 Jun 2021 20:46:45 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:50456) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lsEGX-0004Ax-3Q for emacs-orgmode@gnu.org; Sat, 12 Jun 2021 20:46:17 -0400 Received: from mail-pg1-x531.google.com ([2607:f8b0:4864:20::531]:34304) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1lsEGU-0007td-Aa for emacs-orgmode@gnu.org; Sat, 12 Jun 2021 20:46:16 -0400 Received: by mail-pg1-x531.google.com with SMTP id g22so579864pgk.1 for ; Sat, 12 Jun 2021 17:46:13 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=references:user-agent:from:to:subject:date:in-reply-to:message-id :mime-version; bh=Oll03ryN/Z3QC+chXL6Qs6K/1zb0smfot+PhzZSCxo8=; b=CAPEM55J4s5CDr8PGHVlV8hHO/qxpUEty/liA8PJ2ic6Mr0itpCECoNwiur9/U0061 d9TnwZCcuYdKopn2fkDBvXoUUrrplvSYp1MvSJtRIyZ/Mm/vdN61ewBY0CxwUyNXhDBp 5F3Sbs53KHPmSiHWYiyj96A+v84WrG1SQdS3+zTZEIyllY7rXqFnpsQHlKi25vOvYCOB 2qhms7vBueMd1p/sKx0qbCphP65m8AHhhoBtagGAUEHv5kVr4/Xf7I0jAJh1qVW9o40z znEv647zPVeVOBTQ2/njSgCNmo2ppcBd74TN8nCBErKKjr8+nOrTmUz/FJ5nZwoFHnCb leIQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:references:user-agent:from:to:subject:date :in-reply-to:message-id:mime-version; bh=Oll03ryN/Z3QC+chXL6Qs6K/1zb0smfot+PhzZSCxo8=; b=ePs2kC9bu9iRgLw3YFX2xC2fnCn3U1corfFbO2sasavy2eKYs+YVZ8MARqcIYfrvVZ p4UJTxlBPB1lmZh+slE1o21tBjo2wvoJFhmf5Q0IFygfiVztbwns5xZ5IKuyuSdAMyoN WOJAH+KwvDiQwyS+mQqijSp/yWu1g3UAIRPj9VhTZV8gFvuLEYYonMP96mbZDrf+pYVa Fj+sVIFGIiTfy80mJZwH5nQuwuUZTnMFxbTR6hRVzp9g6VsKsaSsQLsatXe2EE4ty5Xm btXMH2Ixp7X8/1vrX277N7EHXZyFccaFeSCcC/NrVRQxjjVtDMRYbYVXoYysTmDCdJzP uu2g== X-Gm-Message-State: AOAM532j5ebXLB865D+x9w8bOqJwUw5F2B2VJvgsavMEY3blqwZsFUx4 xx9GrzWj/zFyR3ttXyDp+AehiPtActs= X-Google-Smtp-Source: ABdhPJw5/sEtJ2CVpU9fF0T2vAUa7MD9YfS++TOncKJ5YLc5Y55N8M8kFCbHLecWrMe5qidQLtCyKQ== X-Received: by 2002:aa7:8096:0:b029:2f2:fd0d:9e4c with SMTP id v22-20020aa780960000b02902f2fd0d9e4cmr15035292pff.76.1623545172628; Sat, 12 Jun 2021 17:46:12 -0700 (PDT) Received: from tim-desktop (220-235-7-211.dyn.iinet.net.au. [220.235.7.211]) by smtp.gmail.com with ESMTPSA id z5sm8332887pfb.114.2021.06.12.17.46.11 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 12 Jun 2021 17:46:12 -0700 (PDT) References: <643664.1623172504@apollo2.minshall.org> <87sg1rv2jb.fsf@ucl.ac.uk> User-agent: mu4e 1.5.13; emacs 27.2.50 From: Tim Cross To: emacs-orgmode@gnu.org Subject: Re: literate programming, development log -- ideas? (ominbus reply) Date: Sun, 13 Jun 2021 10:31:31 +1000 In-reply-to: <87sg1rv2jb.fsf@ucl.ac.uk> Message-ID: <87r1h6fv72.fsf@gmail.com> MIME-Version: 1.0 Content-Type: text/plain Received-SPF: pass client-ip=2607:f8b0:4864:20::531; envelope-from=theophilusx@gmail.com; helo=mail-pg1-x531.google.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-orgmode@gnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+larch=yhetil.org@gnu.org Sender: "Emacs-orgmode" X-Migadu-Flow: FLOW_IN ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1623545207; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type:in-reply-to:in-reply-to: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=Oll03ryN/Z3QC+chXL6Qs6K/1zb0smfot+PhzZSCxo8=; b=r0Icb1CbGxxerGF0IVRBylZosxRsLN/jbyyB4bQarNK45FGDA5bS6jZgc3NFCy8focRMXf LgNdPZUASTPtGbsrf2W0OMpRmgkv2MGk80SgxLwhF7XWyh5+Kb10biCqj3haykX8+wcbgR 72g3xidW29Cnv3KfRnrp+SzzbHAfgGPv/XkN6yADf6kRAZwzfKoH0ZcDfJYixT810LmwLA Y0IVAAKXezBqy+HUG/fauxY5U83vrKN3jrRIF8HrCwttyxCn4zKTfju6toaC5XDS2uvclu h0o3qa9/ALK/uieH5koLEEXOjeiY3GxfJVZBzsXBjx1qAgkJY8OestgrxD+vbQ== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1623545207; a=rsa-sha256; cv=none; b=sQxTsLfa0yuLTofYNDqyuUFCyhd3eBQw9pw7IO/fmTwMzuIViOhtkrV4iYvbJNCgTxTiek SmCZiLi05BZ7zbgE/1h875tzh13iaN5GD0AscB+dvWjAGCfMIcNjieIHXrrAaLHg8WlRrq mfVk/7V/0WmbN8/OSUxNmmAxRvlpPdv3x77FaFdDG3Pg2ZfIL/bjgyxMn16MgaGTeJOoTq hHjiTa6YZfmSEHRYJIVGsXt0ri++fLOUi02QwNKM2nIVIRKEYMLqiyXgnonzrJi6SbjClU THuqfxTlW98jLIY/NvjbGT8zj2sT41F8heagKLnc1kVeQTNjEdSrBFsH6wX4vw== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20161025 header.b=CAPEM55J; dmarc=pass (policy=none) header.from=gmail.com; spf=pass (aspmx1.migadu.com: domain of emacs-orgmode-bounces@gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=emacs-orgmode-bounces@gnu.org X-Migadu-Spam-Score: -1.63 Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20161025 header.b=CAPEM55J; dmarc=pass (policy=none) header.from=gmail.com; spf=pass (aspmx1.migadu.com: domain of emacs-orgmode-bounces@gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=emacs-orgmode-bounces@gnu.org X-Migadu-Queue-Id: B3129C880 X-Spam-Score: -1.63 X-Migadu-Scanner: scn0.migadu.com X-TUID: Pb8OSb/g0TtM Eric S Fraga writes: > On Tuesday, 8 Jun 2021 at 20:15, Greg Minshall wrote: >> Eric, when you use something RCS-like as your version control system, i >> assume that makes grepping to find some old note easy enough. but, >> these days i tend to use git. when (assuming) you use git, do you have >> some easy way to say "well, i had this code that looked sort of like >> this... where was it?"? (sorry, that's really a git question, but ...) > > Yes, for SRC (RCS-like), it's straightforward to go into the ,v file and > search. For git, I try to make sure the commit message is as > informative as necessary and then search on the log. The alternative is > git-timemachine which allows me to go back and forward in time looking > at the buffer. > > Having said this, I don't often find myself looking for anything in the > history. For major alternatives that might come up during the project, > I use branches. But only with git as I have never figured out how to > get a branch set up in src. Similar here as well. There are some good git tools, like timemachine and git blame and having good commit messages is crucial. However, it really depends on what your use case is. Other suggestions, like maintaining a 'date tree' with sections under that can be really useful for some scenarios. Marking some sections as archived can also be useful. A lot depends on whether what you want is an org file which documents the current state of play or one which is more similar to a lab book which contains a more chronological type evolution of ideas and experiments. I often setup completely separate org 'projects' which will consist of multiple org files and will move things between different files as the project evolves. In some extreme cases, I may even have multiple git branches and will often use git tags to mark specific 'milestones'. How I decide whether to use a date tree with notes, branches, tags, archive sections/files, separate org files etc is typically determined by how likely I might be to want to review or go back through previous work/experiments/decisions. Working this out can take a bit of time and experimentation, but in general, I rarely need to checkout old versions or even open archive trees/files. I do have a journal file for each major project which has lots of ideas, random thoughts and even small experiments (with source blokcs) and I tend ot have a large 'reference' file which contains notes and links to external references and then a 'main' org file, which reflects the current state. -- Tim Cross