1 Introduction

In this piece I’ll explain how I’m maintaining an inventory of what’s in my larder (kitchen: fridge and pantry) by keeping a personal log using Org-modeTK with ledger-cliTK.

1.1 Editorial and License Information

This document was written by emsenn and is released as software under the terms included in the “License” supplement. Please direct comments to their public inbox or, if necessary, email.

2 Steps

2.1 [0/3] Set up your tech stack.

  • [ ] Install Emacs.
  • [ ] Install Org-mode.
  • [ ] Configure Org-babel.

2.2 Create a log.

2.2.1 Create a header

#+TITLE: Larder Log
#+OPTIONS: c:t d:t

2.2.2 Lay out the datetree

* 2019
** 2019-01 January
*** 2019-01-01 Tuesday

2.3 Buy groceries

**** Shopping
#+BEGIN_SRC ledger :noweb yes :tangle larder-demo.ledger
2019/01/01 * Grocery Store
  Inventory:Larder:eggs                    4         @@ $0.99
  Inventory:Larder:sausage                 2    lbs  @@ $1.99
  Inventory:Larder:coffee                 90    tbsp @@ $3.99
  Supplier:Harris Teeter
#+END_SRC

2.4 Make coffee

**** Cooking
#+BEGIN_SRC ledger :noweb yes :tangle larder-demo.ledger
2019/01/01 * Coffee
  Inventory:Larder:coffee                 -3    tbsp
  Life:Eating

2.5 Make dinner

2019/01/01 * Dinner
  Inventory:Larder:eggs                   -4
  Inventory:Larder:sausage                -2    lbs
  Life:Eating
#+END_SRC

Also – and this is important – I don’t really mean Mastodon. I mean the Fediverse: the federation of online information sharing platforms which communicate in some meaningful way with each other.

But I’ll get to that later, perhaps.

This essay you’re reading is in response to the discourse I saw today in the Fediverse, in response to “Mastodon is Crumbling,” an article by Ana Valens for the Daily Dot in which she gives her perspective on the Fediverse, and conducts an interview with Eugen Rochko, the primary develop of Mastodon.

It – this essay – is written for people who are already in the Fediverse, but who might not be familiar with today’s discourse or the mentioned article. It’s where I’m going to share my perspective on the sorts of dicussions that happen about Mastodon and the Fediverse, in the Fediverse, and how I try to think about things myself. In truth, it’s a rant sparked by reading one too many posts about the topic, and feeling like I have to give my two cents. So fair warning, I wrote this in one-go and did very little editing.

1.1 License and Editorial Information

This essay is released under the MIT License and is maintained at https://git.sr.ht/~emsenn/mastodon-is-a-bake-fair.

2 Mastodon, the Fediverse, and ActivityPub, Oh My!

(I bet that’s been used as a header before.)

Mastodon is a piece of software for running a server which provides a frontend for creating and managing an account that lets you make posts that are seen by other people on that server, but also (depending on the post’s settings) to people on other servers, with whom their server federates.

I have an account at @emsenn@tabletop.social – my username is @emsenn and the server (or in Fediverse lingo, instance) is @tabletop.social.

If I make a public post from that account, everyone on the @tabletop.social instance can see it – but so can everyone on the @mastodon.social instance, because my account at @emsenn@mastodon.social follows it. (Or any other account could follow any other account at the respective instances.)

That’s federation. Mastodon is just one software that federates. There are others for microblogging, I know of Pleroma and glitch-soc, and Pixelfed for image-sharing. There’s Write Freely for long-form blogging (Plug: I use it at @emsenn@wordsmith.social and @emsenn@tabletop.press)

For the sake of the headline, ActivityPub is the protocol these services use to federate – it’s how they communicate between each other, so they can make sense of the others’ data. Now, moving on.

3 The Fediverse is Big

The important take-away here is that a lot of the time – most of the time, in my experience – when people talk about Mastodon culture, they’re actually speaking of the Fediverse.

Which means a lot of critiques, like “there’s one developer!” or “it’s a White space” just don’t hold up.

Certain instances are White. Mastodon has just one developer. Neither of those things is the Fediverse.

A lot of the discourse about the “Mastodon is Crumbling” article involved mention of crumbles, the baked goods, which got me to thinking.

4 Explaing the Metaphor in the Headline

The Fediverse is sort of like a bake fair. There’s a lot of different booths (instances). A lot. Each booth has their own styles of pie (the platform they use, whether it’s Mastodon or Pixelfed), but also, their own local culture that makes it their pie.

Sometimes, a style of pie goes out of favor – I mean, when was the last time you had a green tomato pie? Usually because of wider trends in the consumer culture, that exposes some failing in the pie that was probably there the whole time.

Or maybe it was only when the recipe was made at scale and explored by a bunch of different booths that it became clear that it was a culinary dead-end – marshmallow creme pies aren’t couture these days.

But there will be a number of new styles that arise as a fusion of the failed, or as I see it, outgrown, styles. And some that manage to stick around, always begging for a little more perfection – lemon curd.

5 My Opinion

I dont’ think Mr. Rochko is the right developer to maintain a lemon curd. but I also don’t think we’re quite done savoring the marshmallow creme he’s presented with us.

But – one closing thought. I’ve participated, in some way or another, in a lot of online communities in my 28-year-long life. I think a lot of the conversations that are being had are being had with much too narrow a lens, and have very little to do with Mastodon, the Fediverse, or even the Internet.

Communication is communication, and I think if conducting it successfully is truly important to you, it’s a more worthwhile to develop your personal best-practices, and bend the tools you use to best-fit that.

It’s been a while since I sent my last message to this mailing list. My apologies – my new job as a property manager took up more time than expected, and I tinkered too much with my computer so was unable to easily draft something new to write.

Yesterday I worked out those kinks and updated my personal website for the first time since late-January. (There’s still a lot to update, but it’s progress.) In this letter I’m going to just talk about the site for a bit – how it’s laid out, and how it’s made.

I received a lot of feedback about my homepage as soon as I started sharing it. In case it changes, at the moment it is a brief paragraph introducing myself, followed by a list of pages and subdirectories (and subpages), followed by an index.

It’s funny how an index, like what books have, looks so out of place on a website’s index page. Of course, part of why my index looks exceptionally silly is that it also includes all the indexed terms and entries from my fantasy canon, so has entries about the fictional region of the Farsteppes listed right next to entries about the real company Facebook. But, consequence of the site being made for myself, first.

This index page, and all the documents, are generated by Org-mode’s publishing features, from my org directory that looks something like this:

~/org/
     |src/
     .   |index.org
     .   |theindex.org
     .   |theindex.inc
     .   |sitemap.org
     .   |...
     .   |dear-parlour-i-updated-my-website.org
     |templates/
     .         |setupfile0.org
     .         |setupfile-base.org
     .         |setupfile-css-simple.org
     |pub/
         |index.html
         |theindex.html
         |sitemap.html
         |...
         |dear-parlour-i-updated-my-website.html

1 Introduction

This document is a manual of how I style my writing: construct it in a way that I think accurately and precisely communicates my ideas.

1.1 Draft

This document is a draft: it is incomplete in one or more ways.

1.2 Editorial and License Information

This document was written by emsenn and is released as software under the terms included in the “License” supplement. Please direct comments to their public inbox or, if necessary, email.

1.3 Literate Programming

This document is implemented using the literate programming paradigm. The “software” being presented is included as sections of code, within a longer piece of prose which explains the code’s purpose and usage. For a more complete explanation of my implementation of the paradigm, see “Literate Programming” in my Style Manual.

2 The Written Voice

This section contains a general description of the voice I try to use. By voice, I mean the mix of content and style that gives my writing its personality. I wrote every rule in this manual with the primary objective of clarifying my voice.

My tone might change depending on what I’m writing, but my voice should stay consistent.

2.1 Write Respectfully

An important part of my tone is writing respectively: making positive assumptions about the writing’s subject and audience.

To treat the reader with respect:

  • I don’t tell them how to feel.

To treat the subject with respect I:

  • I acknowledge people have qualities, but are not those qualities. (For details, see [Describing a Person](#describing-a-person)).

3 The Rules of Writing

The “rules” of writing are those relatively immutable standards which guide the construction of a clause or sentence. I call them rules because that’s what everyone else seems to call them. Personally, I don’t think they should be viewed that strictly.

3.1 Triage

3.2 Rules of Grammar

3.3 Rules of Punctuation

3.3.1 Rules of Spelling and the Treatment of Specific Words

  1. Spelling
    1. UK or US?
  2. Noun Style Guide
    1. Pronouns
      1. Gender

        I hate that there needs to be this section but there does.

    2. Proper Noun Style Guide
      1. Specific Proper Noun Style Guide

        This section contains how to write specific proper nouns. It is simply a list of proper nouns that Gill and Sennhauser has found itself writing several times, so wanted to establish a precise styling for.

        Noun Notes
        Gill and Sennhauser no ampersand
        Org-mode not “Mode”
        emsenn not captialised
    3. Collective Noun Style Guide
      singular noun formal collective noun(s) comedic collective noun(s)
      congressperson members of congress a swamp
      yak cabinet, herd tangle, gridlock
      lawyer huddle, group tangle
  3. Verb Style Guide
    1. Verb Specifications
      1. “To,” not “in order to,” or “as a way to,”
      2. “Also,” not “in addition”
      3. remove, not extract, eliminate, take away

        I mean, unless those are what make more sense.

      4. use

        Normally, you should use “use” in your sentences, unless you’re speaking of something that is being used in an unusual way, then you can say utilize. But you should probably still say use.

      5. method or methodology

        Usually method, unless it’s not.

  4. Contraction Style Guide

    For my personal tone, I should:

    • Use common contractions:
      • it’s
      • you’re
      • that’s
      • don’t

    In all writing, I should:

    • Never mix contractions and their full form in the same piece. This is bad: If you don’t secure the hatch, you cannot proceed with decompression.
    • Never form contractions from a noun and verb. This is bad: the client’s almost here.

    Use common contractions, such as it’s, you’re, that’s, and don’t, to create a friendly, informal tone.

    Don’t mix contractions and their spelled-out equivalents in UI text. For example, don’t use can’t and cannot in the same UI.

    Never form a contraction from a noun and a verb, such as emsenn’s developing a lot of new cloud services.

    Avoid ambiguous contractions, such as there’d, it’ll, and they’ll.

  5. Adverb Style Guide
    1. Forbidden Adverbs

      Obviously not forbidden, but, avoid them.

      Adverb Suggested alternative
      clearly Drop it. If the sentence feels barren without it, maybe it’s not that clear and you should rephrase.
      completely Whatever it did, it did it. You only need to specify if it was incomplete.
      exceedingly
      excellent
      extremely
      fairly
      few
      huge
      interestingly Leave it to your reader to decide if they’re interested
      largely
      literally
      many
      mostly
      quite
      relatively
      remarkably
      several
      signficantly
      substantially
      surprisingly
      tiny
      various
      vast
      very

      Avoid vague adverbs:

      • clearly
      • completely
      • exceedingly
      • excellent
      • extremely
      • fairly
      • few
      • huge
      • interestingly
      • largely
      • literally
      • many
      • mostly
      • quite
      • relatively
      • remarkably
      • several
      • significantly
      • substantially
      • surprisingly
      • tiny
      • various
      • vast
      • very
  6. Adjective Style Guide
    1. Order of Adjectives
      1. List of the Order of Adjectives

        Adjectives should occur be written in the following order:

        1. Quantity: many, seventeen, a few
        2. Opinion: interesting, good, gorgeous
        3. Size: big, narrow, tall
        4. Quality: broken, uncut, smooth
        5. Shape: square, rotund, triangular
        6. Age: 12-year-old, young, elderly
        7. Color: cerulean, green, pink
        8. Origin: English, Roman, Argentinian
        9. Material: Wood, aluminium, concrete
        10. Type: U-shaped, professional, engineer’s
        11. Purpose: cleaning, camping, baking
      2. Superseding Rules to the Order of Adjectives
        • If you’ve got something that might be a reduplicative (hocus-pocus, mama), it might be worth changing the order to give the noun phrase a better meter. The chief example of this is the big bad wolf.
        • Modifiers to an adjective should directly precede them in the phrase. This is most important for inserting a negation – that is, making sure to write, “there were several not calm individuals gathered at the gates.” /(Note “not calm” would more properly be “excited,” or a more appropriate positive adjective, but “not calm” is more suited for the piece. This demonstrates that even when you violate some rules to achieve the proper voice and tone, you don’t suddenly throw out the others.)
      3. Examples from Literature
        • “It was cold, bleak, biting weather,” in A Christmas Carol by Charles Dickens
        • “He’s an extraordinary looking man,” in The Strange Case of Dr. Jekyll and Mr. Hyde by Robert Louis Stevenson
        • “And each separate dying ember wrought its ghost upon the floor,” in The Raven by Edgar Allan Poe
      4. Examples from Our Portfolio

        Coming soon – just as soon as we have a portfolio!

    2. Adjective Specifications
      1. Apologise Adjective Specification
        Adjective Meaning
        formal An apology given with the relevant authority of the apologizer.
        sincere An apology issued from the individual person who is the apologizer.
        courteous An apology issued as a social habit.
    3. Describing a Person
      1. Describing a part of their identity.
        Identity Phrasing
        Member of a racially marginalized ethnicity person of color
  7. Special Words Style Guide
    1. Reduplicatives

      Reduplicatives are words like mamamish-mash, or bang-bang

3.3.2 Rules of Writing Titles, Names, and Proper Terms

3.3.3 Rules of Writing Numbers and Mathematics

3.3.4 Rules of Abbreviations and Jargon

3.3.5 Rules of Quotations and Dialog

  • When using quotes “improperly”:
    • When using a specific term literally or as a strong metaphor, use “double-quotes”.
    • When using a specific term as a loose analogy, use ‘single-quotes’.

3.3.6 Rules of Phrases and Sentence Construction

  1. Phrasing Style Guide
    1. Avoidable Cliches
      • not rocket science
      • isn’t rocket science
      • outside the box

3.3.7 Rules of Colors and Sensory Descriptions

  • Use the web standard names
  • If sensation is important, treat it like clues in a mystery: provide 3.

3.4 Rules for Words

3.4.1 Centuries

centuries a period of time of 200 or more years
Centuries a period of time spanning multiple Centuries

bad: “silver compounds have been used in film for Centuries.” good: “the use of silver compounds in film has spanned Centuries”

The implication here is the 18th Century is a proper noun, going against more contemporary conventions, but, I agree with the reasoning that brought me to it, so I’m going to adhere to it.

(Credit to @boisdevache@guineapig.party for inspiring this rule.

3.5 Structuring Text

3.5.1 Structuring a Sentence

3.5.2 Structuring a List

3.5.3 Structuring a Paragraph

3.5.4 Structuring a Piece

  1. Sections, chapters, parts? How to use what?

3.5.5 Guidelines for Determining Structure

This section contains guidelines for determining how you should structure a piece of writing, for example a short list of software dependencies the reader will need to install.

3.6 Tone

Tone is that variable element of writing which conveys the piece’s attitude and intention. Word choice, sentence and paragraph structure, layout, and other attributes all factor into defining a pieces tone.

I find it most helpful to define a piece’s tone with adjectives, such as formalcolloquial, or emotional. When creating a piece, I record these as properties, sorted from highest to lowest importance. That is, when two tone adjectives have contradicting rules, the one written first is the one whose rules are followed.

3.6.1 Adjectives

  1. Authentic
  2. Colloquial
  3. Emotional
  4. Formal
  5. Natural
  6. Sophisticated

3.7 Writing for Content Type

3.7.1 Fiction Writing

  1. Mysteries
    • Always give a clue to a reader three ways, and always give the reader three clues.

3.7.2 Marketing Writing

  1. High-End Hotel Description Writing

    The standard tone is sophisticated, natural, and authentic.

  2. Online Landing Page For Service
    1. Structure
      • Headline
      • Proposition
      • Exchanged utility
      • Explanation of Fulfillment
      • Social Proof
      • Closing Argument
      • CTA
  3. Sales Letter

3.7.3 Technical Writing

  1. Guide for Writing Instructions
  2. Guide for Writing Training Procedures
    • Procedures should be written to the trainee: you’re encouraged to use second-person voicing to give direct instructions.
  3. Literate Programming

3.8 Rules of Publishing

3.8.1 Formatting

  1. PDF
  2. HTML
  3. Formatting by Content Type

3.8.2 Licensing ::

3.9 Writing Training and Exercises

3.9.1 About this Section

This section (is in early development and) contains instructions on training staff in how to write.

3.9.2 Writing Flow Training

This training (is in early development and) will teach you how to write a piece, from assignment to submission.

  1. Prerequisites

    This training assumes you have completed the following trainings

  2. Instructions

    This section (is in early development and) contains the individual lessons for this training.

    1. Writing Flow, Lesson One: The Assignment

      This lesson (is in early development and) will teach you about assignments, the unit of work for the writing necessary to accomplish an objective. Some examples of assignments are:

      • a bundle of pieces for a client.
      • a single piece written as a bid for client.
      • a series of emails for an internal marketing campaign.
      1. Assignment Properties

        Assignment properties are standardized pieces of information about an assignment. Assignment properties include things like the piece’s length requirements and its tone. Assignment properties are located in three places, and are inherited on-top of each other in this order:

        • First, the assignment should have whatever properties are in the Assignment Template.
        • Second, the assignment should have whatever properties are recommended by the appropriate style guide.
        • Finally, the assignment may include its own properties.

        Here’s an example of what an assignment’s properties might look like:

        :PROPERTIES:
        :minimum-length: 700
        :recommended-length: 900
        :max-length: 1000
        :tone: sophisticated terse
        :END:
        

3.9.3 Assignment Research Training

This section (is in early development and) will teach you how to conduct research for a writing assignment.

3.9.4 High-End Hotel Description Writing Training

This training (is in early development and) will teach you how to write descriptions for high-end hotels.

  1. Prerequisites

    This training assumes you have completed the following trainings: -Writing Flow Training

  2. Instructions
    1. High-End Hotel Description Writing, Lesson One: Interpretting the Assignment

      This lesson (is in early development and) will teach you how to interpret an assignment.

      Assignments are kept in the Writing Assignments lesson’s assignment is specifically. You may notice the assignment is brief: most assignments will include relatively few guidelines, and will rely on your training and descretion as a writer.

    2. High-End Hotel Description Writing, Lesson Two: Tone and Style

      The tone for this piece should be sophisticated while remaining natural and authentic(Remember to check the section for guidance on these terms.)

      The reader should be addressed in second-person plural, to connect them to the hotel and “travel” through the article. While it’s appropriate to emphasize the luxury of a 5-star hotel, do not over-sell a 3-star hotel.

      The following should be applied over your assignment specification:

      :PROPERTIES:
      :tone: sophisticated natural authentic :perspective: third
      :address: second-person plural
      :END:
      
    3. High-End Hotel Description Writing, Lesson Three: Structure

      Expert opinion (15 words exactly), in the form of a quote, given in the hotel brief. E.g. Tom Gill, London: “A contemporary hotel which provides tranquillity right in the heart of London’s historical city centre.”

      We love (80 words) in a list form

      This highlights why the expert has chosen this offer, explaining what they loved about the hotel and the destination. There should be 4 or 5 ‘We Love’ points which are communicated in the hotel brief.

      Don’t hesitate to add personal touches to the points, e.g. complimentary breakfasts: give examples of what you can eat, where you can eat it.

    4. High-End Hotel Description Writing, Advanced Lesson: Tom’s Musings

      Think of some USPs (unique selling points) that help the hotel stand out. Maybe it’s close to the beach or has a spa facility, the most important thing is drawing in the reader immediately. Don’t forget to mention the location of the establishment, the number of stars, the surrounding areas and the style/architecture of the place.

      Example: “In Saintes-Maries-de-la-Mer, where the Mediterranean Sea and the Rhône Delta meet, one can experience traditional atmosphere and spectacular surroundings. The 5-star hotel, Les Arnelles, is a charming building defined by a harmonious relationship with the great outdoors, both inside and out. Its balance of contemporary and natural aesthetics firmly roots the hotel as the standout place to stay.”

    5. High-End Hotel Description Writing, Advanced Lesson: Room Descriptions

      For each room, write a title with the name of the room included and the size in brackets. Don’t hesitate to reiterate the type of person who could benefit from this room (family, couple). Describe the benefits of the room: the decoration, the surrounding area, etc.

      Mention facilities (complimentary or optional), size, view, style, who can stay (no. of adults/children, babies allowed or not).

      Example: Beach Front Villas (95 m²): “Situated directly on the beach, these villas are ideal for a trip with the whole family; up to two adults and two children can comfortably stay here. You also have direct access to the beach and swimming pool; putting paradise outside your hotel door.”

3.9.5 Writing Training

  1. Creative Writing Training
    1. Writing Prompts
      1. Writing Prompt: Force a Villian on a Vacation

        You have the opportunity to take someone you dislike – fictional or real – and send then anyplace you choose – real, on earth. You have now intercepted a post card from this person sent back to their associates. What does it say?

      2. Writing Prompt: You’re a Disgruntled Baby

        Continue this sentence: “I know I’m only 20 months old, but I don’t think it’s right that my parents…”

      3. Writing Prompt: You’ve Won!

        Continue this sentence: “When I received the letter, I almost threw it away. It looked like a scam. When I opened it, it definitely looked like a scam. No one just gives this sort of thing away. But here I am, watching the delivery crew drop off a brand new…”

      4. Writing Prompt: Give Them a Condiment
        • [ ] Think of three fictional characters and write them down:
        • In that order, describe each – in a complimentary manner – by comparing them to the following condiment:
          • Ketchup
          • Mayonnaise
          • Peanut Sauce
  2. Training exercises
    1. Word Substitution and Sentence Reconstruction Training Exercises
      1. Word Substitution and Sentence Reconstruction Exercise: Write Around Character Replacements
        • [ ] Go to Wikipedia and find a random article.
        • [ ] Write 150 words about the topic. Choose your own writing type and tone.
        • [ ] In your piece, use the table below to replace characters. For each row in the column, go to whatever character position is suggested, and replace it with the suggested character. Rewrite the text to make sense around the character, replacing words or sentences as needed, while keeping the document truthful to the Wikipedia article on which it is based – and keeping the characters in the right position!
        POSITION CHARACTER
        12 e
        88 p
        156 i
        287 o
      2. Word Substitution and Sentence Reconstruction Exercise: Konami Code

        Like “Write Around Character Replacements”, but with the Konami Code.

    2. Comparative Writing Training Exercises
      1. Comparative Writing Exercise: Neither Slinky nor Scarf

        Describe a snake by writing the ways in which it is unlike a slinky and scarf, but you may not directly mention the snake, slinkies, or scarves.