πŸ“š node [[agora chapter]]

Some loose notes about the process of writing/editing this follow, started on [[2022-10-27]] as I'm starting to go through editors' comments to try to get the chapter into a good enough shape to call it done.

First of all, it's super useful and informative (a learning experience) to have professional editors go through the document. Regardless of the outcome I'm glad I get to have this experience!

Second of all, I procrastinated a bit on starting to go through comments due to a pretty irrational sense of fear that the chapter was unreadable/unrepairable. I think it turns out there's plenty to be saved and repurposed for the final draft :) I'm also happy that I took some days off work, as it is indeed the time to dedicate real time to this project in a relatively uninterrupted way.

--

#meta I wonder if anagora.org supports rulers yet or I just dreamt it?

[[2022-11-06]]. [[Five minutes of rest]], so I write here :)

Loving [[termdown]] shaped into my simple [[pomodoro]] script.

Meditating every rest, at least three breaths (~33 seconds).

I got derailed trying to stream myself work in [[yoga with x]]. Having fun in the process, but I must not fool around now too much; I don't want the day to be derailed.

It is currently [[2022-11-06]] [[15:20]]. I'll now shoot for [[eight pomodoros]] on top of the four we've done so far :)

⸎

On it then. First pomodoro ticking, 15m to go.

[[Agora of Flancia]] ~ [[Flanciagora]]?

Β§

I'm happier with how the structure looks after eight pomodoros today :)

Now [[yoga with x]].

~

Thirteen pomodoros in, three to go. Having fun :)

Hmm, here we are again :)

This is now [[2022-11-28]]. The deadline for the next round of comments is [[2022-12-04]].

(This is my #drishti currently, meaning that I have set it to the number four, representing the date.)

I will now work on a different computer :)

If you somehow found this recording and you don't know what it's all about, you can check https://anagora.org/yoga-with-x and you'll find links to other recordings :)

  • #push [[todo]]
    • Wow, I really need to maintain the Agora root repository. I haven't touched it in, well, maybe a year? I need to check. And it is the reason I keep thinking 'the Agora index doesn't read great.'

2023

Still working on this on [[2023-01-02]], enjoying it although I'm a bit delayed :)

My current attitude is: some bits of this are readable, if in need, chop what's not and publish what remains :)

[[2023-01-02]]

I plan to do 4 to 8 pomodoros on this tonight, although friends are coming over, so some of them might be later at night :) And I'm fine with 4.

Let's see how it goes though. It's 17:40 now, but the house is ready and dinner is simple.

[[2023-01-07]]

Back in this part of town! Starting pomodoros at 15. I hope to be able to finish this today. I'm primary oncall for Meet but oncall on weekends is usually quiet; let's see :)

  • #push [[agora chapter]] deadline today, let's see how far I get! today I hope to start early and finish late.
    • General [[patterns]] identified by the editors
      • #G1 too many links / links which aren't explicitly wikilinks
        • Strategy: cut links by 50%, add back [[wikilink markers]] for all remaining links (makes me "pay for them" in a way)
      • #G2 should address the reader of the book more than the user of an Agora
      • #G3 lacking information on similar initiatives/prior work
      • #G4 should be less of a manifesto and more a concrete description of the system that integrates PKGs
      • #G5 lacks cohesion, add transitional paragraphs
      • #G6 repetition
      • #G7 Agora discussed as having agency (might be OK, but might also be confusing)
      • #G8 use of bullet points which should be written as long form text
  • #push [[agora chapter]] is my top priority today
    • tour the agora
      • take screenshots
        • add two or three to the doc
        • file bugs :)
    • resolve more comments
      • and more
      • and more :)
  • #push [[agora chapter]]
    • my next [[drishti]] -> [[2022-12-04]] is the [[deadline]] for the next iteration
    • answer [[editors]]
      • write email
    • start going through comments and incorporating learnings
    • note that UI improvements can yield more interesting screenshots
      • but at least one screenshot of an agora graph is long due
  • #push [[agora chapter]]
    • my next [[drishti]] -> [[2022-12-04]] is the [[deadline]] for the next iteration
    • answer [[editors]]
      • write email -- this was sent on [[2022-11-27]] in the end
      • answer follow up about the meeting, sounds nice
    • start going through comments and incorporating learnings
    • note that UI improvements can yield more interesting screenshots
      • but at least one screenshot of an agora graph is long due
      • ;)
  • #push [[agora chapter]]
    • talked to the editors about open comments/suggestions, will now batch resolve a lot of them :)
    • finish resolving unlinked suggestions to improve readability end to end
    • add references / move towards 'no open TODOs'
  • #push [[agora chapter]] next steps
    • read George's email.
      • end of week as deadline for all, then we need to....
        • work on updated abstracts and...
        • start on the Markdown port.
πŸ“– stoas
β₯± context
β₯… related node [[agora chapter 2]]
β₯… related node [[agora chapter appendix]]
β₯… related node [[agora chapter final]]
β₯… related node [[agora chapter unlinked]]
β₯… related node [[agora pkg book chapter]]
β₯… related node [[agora pkg chapter]]
β₯… related node [[agora pkm chapter]]
β₯… related node [[things to do after agora chapter]]