unwrap markdown files using Prettier
This commit is contained in:
parent
43b4de7eb8
commit
8e55f10bdb
|
@ -2,6 +2,6 @@
|
|||
"trailingComma": "es5",
|
||||
"semi": false,
|
||||
"singleQuote": true,
|
||||
"proseWrap": "always",
|
||||
"proseWrap": "preserve",
|
||||
"editorconfig": true
|
||||
}
|
||||
|
|
|
@ -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 things–an 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 things–an 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 style–that is, the poet's own determined goals
|
||||
> set out in the technical apparatus that will best achieve those goals–begins
|
||||
> to be embraced. (Oliver, 1994, p. 14).
|
||||
> Imitation fades as a poet's own style–that is, the poet's own determined goals set out in the technical apparatus that will best achieve those goals–begins to be embraced. (Oliver, 1994, p. 14).
|
||||
|
||||
## The tools of the trade
|
||||
|
|
|
@ -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.
|
||||
|
|
|
@ -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
|
||||
|
||||
|
|
|
@ -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.
|
||||
|
||||
|
|
|
@ -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).
|
||||
|
|
Loading…
Reference in a new issue