Sacha Chua <[email protected]> writes: > Hello, all! Trying to dust off and reorganize the tutorials page at > https://orgmode.org/worg/org-tutorials/ . These changes are also > available in my https://git.sr.ht/~sachac/worg/tree/tutorials branch > (ex: > https://git.sr.ht/~sachac/worg/tree/tutorials/item/org-tutorials/index.org)
Hi, Sacha, Thanks so much for this! This dusting-off is a task I've dreaded tackling. Apologies for the delayed response. I have a few questions/suggestions below. Also let me know if you have ideas/plans for further changes to org-tutorials/index. > * org-tutorials/index.org: Focus the first part of the page on recent > tutorials, remove dead links, merge special tasks, remove more > intermediate/advanced things "Remove" here means "remove from the first part", not delete from the page, right? Perhaps "move down" instead? > * org-tutorials/orgtutorial_dto-fr.org (Introduction): Update links to > translations. > * org-tutorials/org-meeting-tasks.org (Requirements): Remove paragraph > describing 2011 as bleeding edge. Thanks for these patches. Looks good! > [2. Updating worg tutorials --- text/x-diff; > 0001-org-tutorials-Clean-up-dead-links-reorganize-update.patch]... > -* General Introductions to Org-mode > +#+begin_comment > +The goal of this document is to list a few useful tutorials for Org mode > newbies so that they can pick up the basics without getting overwhelmed. > There should be a mix of text-based and video resources to accommodate > different people's learning preferences, and we can prioritize recent > resources instead of being an exhaustive list. > +#+end_comment This is a good mission statement, and we need to retire old materials when they become actively confusing. (It's time to forget the "Remember" section, among other things.) But I do think that, as an index page, it should be exhaustive with regard to materials /on Worg/. Let's keep the whole document hard-wrapped. > -- Org-mode video tutorials by Raoul Comninos, a two-part series consisting > of 20 videos (of around 6-7 minutes each) that explain the fundamentals of > Org-mode simply and clearly. > - - [[https://youtu.be/QlYQijQCNHU][Org-mode video tutorials -- Part 1]] > - - [[https://youtu.be/-2kQNmfVzAI][Org-mode video tutorials -- Part 2]] I see that these have become unavailable. They were quite recent and a nice effort, so I've contacted the author to ask if they've moved to a new location, but we can go ahead with the patch and put them back in later. > +- [[file:org4beginners.org][Org mode: Beginning at the Basics]] by Alexander Poslavsky > +See the [[file:org-screencasts/index.org][Screencasts]] page for a > list of Org mode screencasts. I've made a note to update/prune that page, but that's for another day. > - - [[https://github.com/novoid/org-mode-workshop][Org-mode Workshop]] by > Karl Voit, conducted at [[http://www.TUGraz.at][Graz University of > - Technology]] in November 2012 (3x4 hours). It includes a newer version > - of the feature-show from the entry above. > - - [[file:org-outside-org.org][Org-mode outside Org-mode]] by Thorsten > Jolitz and François Pinard. An > - introduction to the available libraries for using Org-mode's concepts and > - Org-mode's functionality outside of Org-mode files, e.g. when working > with > - programming-language source-code files. I think we can keep these somewhere? We can drop "the entry above", since it refers to essentially the same presentation, but the link is live and goes to a repo with Karl's Org outline for the workshop. And Thorsten and François' intro to outshine/outorg is on Worg and, I think, still relevant. I agree it belongs some distance from the beginning of the page. > +* Writing Yes, great. I'm wondering if we should even split this section into one on "Writing" and one on "Note-taking" with ample room for org-roam and friends. What do you think? > + - [[https://www.youtube.com/watch?v=FtieBc3KptU][Emacs For Writers - > YouTube]] (1:01:06) Emacs For Writers, video by Jay Dixit (1:01:06) (Let's start refraining from using "YouTube", "GitHub" etc. in link descriptions because it's going to look odd once we start to rewrite links to sites with non-free JS.) I see you've included the note-taking article from lucidmanager.org, but perhaps we should give overview links to the whole Emacs Writing Studio series? E.g.: [[https://www.youtube.com/watch?v=5IJVDCpE3vA][Introduction to Emacs Writing Studio (video, 25:27)]] and [[https://lucidmanager.org/tags/emacs/][website]] accompanying /Emacs Writing Studio/ by Peter Prevos, with configuration and workflow tips for writers. > + - > [[https://newartisans.com/2007/08/using-org-mode-as-a-day-planner/][Using > org-mode as a Day Planner]] (2007) by John Wiegley > + - > [[https://sachachua.com/blog/2007/12/how-to-use-emacs-org-as-a-basic-day-planner/][How > to use Emacs Org as a Basic Day Planner]] (2007) by Sacha Chua :) > +* Appearance > + - [[https://github.com/minad/org-modern][minad/org-modern: Modern Org > Style · GitHub]] Neat! > +** Literate programming Good addition. > ** Reproducible research Let's rename this section just "Research", since not all the entries deal specifically with "reproducible research" anymore. > +- [[https://www.youtube.com/watch?v=oJTwQvgfgMM][Google Tech Talk about > Org-mode]] (2008), a 45 minute talk given by Carsten > + Dominik during a visit at > [[http://maps.google.com/%3Fq%3D37.423156,-122.084917%2B(Google > Inc.)&hl%3Den][Google]]. > +- [[https://www.youtube.com/watch?v=WgyRdnjRI4o][Organizing a Scientist's > Life and Work]] (2019), a 45 minute talk given by > + Carsten Dominik during a visit at the [[http://www.nf.mpg.de/][Max-Planck > Institute for > + neurological Research Cologne]]. > +- On [[http://twit.tv/floss136][FLOSS Weekly Episode 136]] (2010, > Audio+Video download available) > + Randal Schwartz interviews Carsten Dominik about Org-mode. I only just realized now that the "org-mode in science" heading didn't fit most of these video talks by Carsten in the first place. The Google Tech Talk and the FLOSS interview really both belong under "General introductions" (they're old, but they're good, and you've helpfully added dates). Only the Max-Planck one focuses on Org for scientific research (in the second half). Thanks again, Christian
