unwrap markdown files using Prettier

This commit is contained in:
Nils Norman Haukås 2023-03-28 07:01:50 +02:00
parent 43b4de7eb8
commit 8e55f10bdb
6 changed files with 18 additions and 59 deletions

View file

@ -2,6 +2,6 @@
"trailingComma": "es5",
"semi": false,
"singleQuote": true,
"proseWrap": "always",
"proseWrap": "preserve",
"editorconfig": true
}

View file

@ -8,28 +8,14 @@ Let's learn enough of poetry theory to be dangerous.
Firstly, poems need not rhyme.
> The poems of the past, however, present a singular and sometimes
> insurmountable problem. You can guess what it is: metrics. Poems written with
> rhyme and in a fairly strict metrical pattern, which feel strange and even
> "unnatural" to us, were not so strange to our grandparents. They heard such
> poems in their childhood [...] by that bard of the nursery, Mother Goose. In
> their literary efforts, imitating what they had heard, they wrote poems in
> meter and rhyme. It came, you might say, naturally. (Mary Oliver,
> [A poetry handbook](https://www.goodreads.com/book/show/71652.A_Poetry_Handbook),
> 1994, p. 14)
> The poems of the past, however, present a singular and sometimes insurmountable problem. You can guess what it is: metrics. Poems written with rhyme and in a fairly strict metrical pattern, which feel strange and even "unnatural" to us, were not so strange to our grandparents. They heard such poems in their childhood [...] by that bard of the nursery, Mother Goose. In their literary efforts, imitating what they had heard, they wrote poems in meter and rhyme. It came, you might say, naturally. (Mary Oliver, [A poetry handbook](https://www.goodreads.com/book/show/71652.A_Poetry_Handbook), 1994, p. 14)
Secondly, to write poems is to be someone who:
> [...] stands between two marvelous and complex thingsan experience (or an
> idea or a feeling), and the urge to tell about it in the best possible
> conjuction of words. (Oliver, 1994, p. 3).
> [...] stands between two marvelous and complex thingsan experience (or an idea or a feeling), and the urge to tell about it in the best possible conjuction of words. (Oliver, 1994, p. 3).
To write poetry we should imitate to learn. Think of any poem or maybe just an
idea of what you _think_ a poem is and start there, write like that, and
continue from there. Read, imitate, learn, build your voice.
To write poetry we should imitate to learn. Think of any poem or maybe just an idea of what you _think_ a poem is and start there, write like that, and continue from there. Read, imitate, learn, build your voice.
> Imitation fades as a poet's own stylethat is, the poet's own determined goals
> set out in the technical apparatus that will best achieve those goalsbegins
> to be embraced. (Oliver, 1994, p. 14).
> Imitation fades as a poet's own stylethat is, the poet's own determined goals set out in the technical apparatus that will best achieve those goalsbegins to be embraced. (Oliver, 1994, p. 14).
## The tools of the trade

View file

@ -8,9 +8,7 @@ favicon: 🏋️,
1. We are going to set a timer for five minutes.
1. During those minutes we'll write freely.
- By writing freely I mean to write about any theme, in any format, forming
any thoughts, in any shape. And if you repeat words, change your mind
mid-sentence, drop typos left and right, that's totally fine.
- By writing freely I mean to write about any theme, in any format, forming any thoughts, in any shape. And if you repeat words, change your mind mid-sentence, drop typos left and right, that's totally fine.
- The goal is to lower any blockers against writing.
- Just keep writing.
- This text will not be read aloud.

View file

@ -4,27 +4,15 @@ title: Writing poetically
# Writing poetically
Not many programmers write poems, but quite a few write well. One might even
argue that some write poetically?
Not many programmers write poems, but quite a few write well. One might even argue that some write poetically?
Let's look at a few examples.
> Pascal is for building pyramids — imposing, breathtaking, static structures
> built by armies pushing heavy blocks into place. Lisp is for building
> organisms — imposing, breathtaking, dynamic structures built by squads fitting
> fluctuating myriads of simpler organisms into place. [...] As a result the
> pyramid must stand unchanged for a millennium; the organism must evolve or
> perish.
> ([Structure and Interpretation of Computer Programs](https://en.wikipedia.org/wiki/Structure_and_Interpretation_of_Computer_Programs),
> 1996, p. xvii)
> Pascal is for building pyramids — imposing, breathtaking, static structures built by armies pushing heavy blocks into place. Lisp is for building organisms — imposing, breathtaking, dynamic structures built by squads fitting fluctuating myriads of simpler organisms into place. [...] As a result the pyramid must stand unchanged for a millennium; the organism must evolve or perish. ([Structure and Interpretation of Computer Programs](https://en.wikipedia.org/wiki/Structure_and_Interpretation_of_Computer_Programs), 1996, p. xvii)
> (...) SQLite also thrives at the edge of the network, fending for itself while
> providing fast and reliable data services to applications that would otherwise
> have dodgy connectivity.
> ([SQLite docs](https://web.archive.org/web/20230311174317/https://www.sqlite.org/whentouse.html))
> (...) SQLite also thrives at the edge of the network, fending for itself while providing fast and reliable data services to applications that would otherwise have dodgy connectivity. ([SQLite docs](https://web.archive.org/web/20230311174317/https://www.sqlite.org/whentouse.html))
> A calculator for humanity's peculiar conventions of time.
> ([D3.js docs on time intervals](https://github.com/d3/d3/blob/main/API.md#time-intervals-d3-time))
> A calculator for humanity's peculiar conventions of time. ([D3.js docs on time intervals](https://github.com/d3/d3/blob/main/API.md#time-intervals-d3-time))
## Book recommendations

View file

@ -4,20 +4,15 @@ title: Day two
# Day two
Rain. It's raining outside. And it's day two of this bewildering summer coding
job that might actually be without any coding, just writing code comments.
Rain. It's raining outside. And it's day two of this bewildering summer coding job that might actually be without any coding, just writing code comments.
You stare out the window for a while.
Hmm. I might as well look at the code.
This is getting stranger and stranger. This looks like a JavaScript library
written in an object-oriented programming style. And this is what they want me
to document?
This is getting stranger and stranger. This looks like a JavaScript library written in an object-oriented programming style. And this is what they want me to document?
You lean back in your chair with a groan. It's still raining outside and time
seems to be on the verge of going backwards. That's how threateningly dull it
is.
You lean back in your chair with a groan. It's still raining outside and time seems to be on the verge of going backwards. That's how threateningly dull it is.
Ok. They want me to document. How about I write some poetry? That should do it.

View file

@ -4,24 +4,16 @@ title: The summer job
# The summer job
"Man the machine, that's what we do." That was one of the first lines served to
you by your surly supervisor.
"Man the machine, that's what we do." That was one of the first lines served to you by your surly supervisor.
It had been late in spring before you manged to get a summerjob as a
student-programmer. Now on your first summer workday you realise that you might
not get to do any programming at all.
It had been late in spring before you manged to get a summerjob as a student-programmer. Now on your first summer workday you realise that you might not get to do any programming at all.
"You see kiddo", management has decreed that there be no code changes for the
rest of the year. We have already deployed the yearly sanctioned release to our
most valued customers.
"You see kiddo", management has decreed that there be no code changes for the rest of the year. We have already deployed the yearly sanctioned release to our most valued customers.
However, there's the matter of documentation. Did you get the memo?
Management recently visited an IT-conference. In their words it was "truly
illuminating." Consequently they've decided that the amount of commented code
should increase by 50% throughout the company. No ifs, ands, or buts about it.
Management recently visited an IT-conference. In their words it was "truly illuminating." Consequently they've decided that the amount of commented code should increase by 50% throughout the company. No ifs, ands, or buts about it.
Somewhat flabbergasted you open your work laptop to try and figure out how to
make your work... work.
Somewhat flabbergasted you open your work laptop to try and figure out how to make your work... work.
Next: [Day two](/work/day-two).