Re: [Emacspeak] Tips and tricks for learning a new codebase?

[Parham Doustdar <parham90@xxxxxxxxx>]

Hey Robert,
Not sure if you know this, so putting it here in case you don't, but the things you list under your "can get clever" are actually very easy to do with no coding. Just bind org-capture to a global hotkey, then press it when you want to make a note about the line you are just reading. Then you can insert the link in an org buffer using C-c C-l I think, and the line you had captured would be in the history, which you can go through using the arrow keys.
Also, what I often do is keep my notes open in a separate window (or tab in MacOS terms) by pressing C-x 4 b. Then I can use C-x o to jump between the code (open in one window) and my notes (open in another window).
I'll leave the rest to others to answer, as I often struggle with spaghetti code myself.'
Sent from my iPhone

> On Feb 12, 2024, at 16:34, Robert Melton <emacspeak@xxxxxxxxxxxxx> wrote:
> 
> Curious if there are any recommendations for learning new codebases.
> 
> I am currently fighting a rather complex codebase for a web app and wondering
> if the community has any tricks for staying sane when trying to spin up on new
> projects.  
> 
> Thus far I have played a good bit with folding, which I like the idea of because
> it makes it easy to skip over or dig in on a block, and while I like the notion of
> it, I hate the actual experience.
> 
> Right now, I am mostly maintaining a notes file on the project as I go and
> learn each piece, can get clever I think and drop links into the files, or
> even sort of build my own annotate by binding a keypress to jump to my
> org file and come back.
> 
> Any tools or techniques I should add to my bag of tricks?  
> 
> --
> Robert "robertmeta" Melton
> lists@xxxxxxxxxxxxxxxx <mailto:lists@xxxxxxxxxxxxxxxx>
> Emacspeak discussion list -- emacspeak@xxxxxxxxxxxxx
> To unsubscribe send email to:
> emacspeak-request@xxxxxxxxxxxxx with a subject of: unsubscribe