mirror of
https://github.com/by-jp/www.byjp.me.git
synced 2025-08-09 05:36:07 +01:00
Fix links
This commit is contained in:
JP Hastings-Spital
parent
7201344370
commit
233a0098c5
39 changed files with 42 additions and 35 deletions
1
.gitignore
vendored
1
.gitignore
vendored
|
|
@ -1,3 +1,4 @@
|
|||
/public/
|
||||
/resources/_gen/
|
||||
/.hugo_build.lock
|
||||
/.lycheecache
|
||||
|
|
|
|||
12
.lycheeignore
Normal file
12
.lycheeignore
Normal file
|
|
@ -0,0 +1,12 @@
|
|||
https://covers.openlibrary.org/b/id/%.0f-M.jpg
|
||||
https://covers.openlibrary.org/b/isbn/%s-M.jpg
|
||||
https://www.cloudflare-ipfs.com/ipfs/QmWSnMtmfh78EdKjztRMRLFufk4BMKN3nSvqZBR5g8aDWF
|
||||
https://help.instagram.com/181231772500920
|
||||
layouts/*
|
||||
https://byjp-addshortlink.express.val.run/example?to=https://example.com
|
||||
http://foo.bar/guid
|
||||
http://nowsay.it/waterwingflapjack
|
||||
https://indieauth.com/auth
|
||||
https://github.com/by-jp/www.byjp.me/tree/%7B%7B%20.%20%7D%7D
|
||||
http://lucy.byjp.me/*
|
||||
https://twitter.com/RealFakeFacts/status/409062831355486208
|
||||
|
|
@ -31,8 +31,8 @@ I'm getting older, and sites I've been creative on are dying or becoming marketi
|
|||
* My friend created a beautiful alphabet, I turned it into a font and 👨🎤 [performance microsite](https://caspian.byjp.me). Read or listen to 📖 [the story right here](/posts/the-beauty-of-type).
|
||||
* I once studied biomedical physics, so when I had an MRI of my head I jumped at the opportunity to extract a 3D model of my brain and 🧠 [render it in WebGL online](https://brain.byjp.me/).
|
||||
* I built a clockface that counts 🕰 [the seconds since I was born](https://tictoc.byjp.me/). In binary.
|
||||
* I helped by friend learn about website infrastructure by building a microsite of her favourite moment in film… 🐶 [wanna hear the most annoying sound in the world?](https://wannahearthemostannoyingsoundintheworld.byjp.me).
|
||||
* Maybe you'll like this little guy 🐙 [called tako](https://tako.byjp.me).
|
||||
* I helped by friend learn about website infrastructure by building a microsite of her favourite moment in film… 🐶 [wanna hear the most annoying sound in the world?](https://bafybeieksph4ppkssaccuoig3dx6zyw4qouyooctd2sti5eaigx2jq57ka.ipfs.dweb.link).
|
||||
* Maybe you'll like this little guy 🐙 [called tako](https://bafybeihwkqswvfggjqhh4fgeioq7xapzxolkb7ptmir22kovahnlzjmnfm.ipfs.dweb.link/).
|
||||
|
||||
## Postcards
|
||||
|
||||
|
|
|
|||
|
|
@ -6,4 +6,4 @@ _build:
|
|||
list: never
|
||||
---
|
||||
|
||||
Something went wrong while trying to register your donation. If you weren't using the form on the [thanks page](../thanks/) then please try there, otherwise please [reach out to me by email](../standing-invitation/).
|
||||
Something went wrong while trying to register your donation. If you weren't using the form on the [thanks page](/thanks/) then please try there, otherwise please [reach out to me by email](/standing-invitation/).
|
||||
|
|
|
|||
|
|
@ -10,6 +10,6 @@ Thank you so much! It makes me _enormously_ happy that you're appreciating my wo
|
|||
|
||||
Money can set up some very strange incentives in humans, but donating to a charity, supporting a person who inspires you, investing in your community, and so many other acts of openness bring us closer together — for me, the entire point of all this.
|
||||
|
||||
If you'd like to tell me about the person, group or cause that you contrinuted to on my behalf I'd [love to hear about it](../standing-invitation/)!
|
||||
If you'd like to tell me about the person, group or cause that you contrinuted to on my behalf I'd [love to hear about it](/standing-invitation/)!
|
||||
|
||||
_By the way, the counter on the [thanks page](../thanks/) can take a few minutes to update!_
|
||||
_By the way, the counter on the [thanks page](/thanks/) can take a few minutes to update!_
|
||||
|
|
|
|||
|
|
@ -14,4 +14,4 @@ I continue to enjoy reading Atkins & Johnson's "A Dodo at Oxford"; it is at leas
|
|||
|
||||
|
||||
|
||||
This section is about some cards left inside the antique diary which is the subject of the book; do get yourself a copy, or borrow mine when I'm done\! http://www.oxgarth.co.uk/a-dodo-at-oxford.html
|
||||
This section is about some cards left inside the antique diary which is the subject of the book; do get yourself a copy, or borrow mine when I'm done\! https://oxgarth.co.uk/product/a-dodo-at-oxford-2/
|
||||
|
|
@ -10,10 +10,8 @@ tags:
|
|||
---
|
||||
I started my own postal service…
|
||||
|
||||
|
||||
|
||||
If you find me, I'll deliver a postcard for you anywhere on earth. Some will arrive quickly, some will take years, so why not post one somewhere unusual and send me on an adventure?
|
||||
|
||||
[justpostcards.co.uk](http://web.archive.org/web/20161015062435/http://www.justpostcards.co.uk/)[^1]
|
||||
|
||||
|
||||
http://justpostcards.co.uk
|
||||
[^1]: I've since given up this domain, but the link points to a copy on the wayback machine!
|
||||
|
|
|
|||
|
|
@ -10,10 +10,6 @@ tags:
|
|||
---
|
||||
You know your friendship is valued if, when they travel, you receive postcards from the most glorious places on earth telling you to "Shut up, JP" in a wide variety of \(expertly researched\) languages.
|
||||
|
||||
|
||||
|
||||
These were just the first 5 to hand…
|
||||
|
||||
|
||||
|
||||
http://shutup.claire.im
|
||||
[shutup.claire.im](https://bafybeicxpgihxyjnia437rac3prccj6vspii7ti2podclzqzzoakiu5g2y.ipfs.dweb.link)
|
||||
|
|
|
|||
|
|
@ -25,4 +25,4 @@ Sadly, by removing my accounts, I'll lose my ability to reach out to long-lost f
|
|||
|
||||
**I'll be leaving just after my birthday this year, June 16th** (as anyone inclined to wish me well then is someone who may want to know where I've gone to!) but you can find me online in a host of other, more friendly and sedate, places already (check the [byJP.me homepage](https://byjp.me) for the up-to-date ones).
|
||||
|
||||
You can also [send me a postcard](posts/thoughts-on-postcards/), or message me on _[Signal](https://signal.org/)_, _iMessage_, and (if you twist my arm) _WhatsApp_. For my address or my phone number, being more sensitive, just say hello [by email](mailto:hello@byjp.me), and I'll excitedly share with you!
|
||||
You can also [send me a postcard](/posts/thoughts-on-postcards/), or message me on _[Signal](https://signal.org/)_, _iMessage_, and (if you twist my arm) _WhatsApp_. For my address or my phone number, being more sensitive, just say hello [by email](mailto:hello@byjp.me), and I'll excitedly share with you!
|
||||
|
|
|
|||
|
|
@ -99,7 +99,7 @@ If you'd also like an API to add a new shortlink, you'll need a [val.town](https
|
|||
|
||||
## Caveats & thoughts
|
||||
|
||||
I'd like to build a [Raycast](raycast.com) extension for making new shortlinks. It's stopped raining now, so maybe later!
|
||||
I'd like to build a [Raycast](https://raycast.com) extension for making new shortlinks. It's stopped raining now, so maybe later!
|
||||
|
||||
If you try to post new shortlinks with the val.town API faster than the deploy time for the repo then your API call will be rejected, and you'll have to try again. I'd like to get some auto-retries in there.
|
||||
|
||||
|
|
|
|||
|
|
@ -81,7 +81,7 @@ As I see it there are two foundational and relevant changes to the global post-m
|
|||
|
||||
You may see where I’m going with this: trade is no longer bound by geography. When I use the internet to buy a Chinese-made light bulb, it still has to be shipped to me; if I want to buy a computer game on a physical disc, there needs to be a store for me to walk into; but if an engineer sells her software through the internet she could be on the moon and the only difference to her being in the next door room would be the 1.3 second delay in delivery time imposed by the speed of light. Clearly if you don’t need to rely on a physical store or distribution network your business is simpler and cheaper to run, I believe the same is true for non-physical currencies.
|
||||
|
||||
So what currency does our hypothetical lunar coder—let’s call her Ada—charge her customers in? She weighs up the benefits each currency provides in terms of spending power (money is useless to her unless she can spend it), stability (so that a week’s work isn’t worth only a loaf of bread by Saturday), and the features that currency offers (like fungibility, being [backed by gold](http://www.bankofengland.co.uk/banknotes/pages/about/faqs.aspx#general) or being [accepted in more countries](https://en.wikipedia.org/wiki/International_use_of_the_U.S._dollar) than any other).
|
||||
So what currency does our hypothetical lunar coder—let’s call her Ada—charge her customers in? She weighs up the benefits each currency provides in terms of spending power (money is useless to her unless she can spend it), stability (so that a week’s work isn’t worth only a loaf of bread by Saturday), and the features that currency offers (like fungibility, being [backed by gold](http://web.archive.org/web/20171123012558/http://www.bankofengland.co.uk:80/banknotes/Pages/about/faqs.aspx) or being [accepted in more countries](https://en.wikipedia.org/wiki/International_use_of_the_U.S._dollar) than any other).
|
||||
|
||||
So, if we assume cryptocurrencies have enough features that they gain popularity, and thus the _potential_ for spending power and stability, what features do they have that would make them a good choice for pure-digital traders?
|
||||
|
||||
|
|
|
|||
|
|
@ -23,7 +23,7 @@ Are you pissed off with the rounded profile pics that Facebook has decided to us
|
|||
|
||||
## How to install
|
||||
|
||||
All you need to do is go into the GlimmerBlocker Preference pane, go into filters, hit the little cog next to + and - under _filters_ and subscribe to my filter using the following address: [http://dropbox.kedakai.co.uk/GlimmerBlocker/Facebook.xml](http://dropbox.kedakai.co.uk/GlimmerBlocker/Facebook.xml)[^1]
|
||||
All you need to do is go into the GlimmerBlocker Preference pane, go into filters, hit the little cog next to + and - under _filters_ and subscribe to my filter using the following address: ~~dropbox.kedakai.co.uk/GlimmerBlocker/Facebook.xml~~[^1]
|
||||
|
||||
Let me know if there are any other annoyances I could add to this filter!
|
||||
|
||||
|
|
|
|||
|
|
@ -12,7 +12,7 @@ tags:
|
|||
|
||||
Well, I'm back from Japan and while I was there I kept an online journal (Tumblr, you rock) to let everyone at home know what was going on. To make things even cooler I vowed to keep the posts tagged with where I was while I was writing them, of course tumblr has no functionality for this so I hacked up a geotagging solution using javascript.
|
||||
|
||||
After making a [formal request for geotagging features](https://getsatisfaction.com/tumblr/topics/geotagging_of_individual_posts)[^1] on their GetSatisfaction pages, someone asked me how I got it done, so I created a (very sloppy) [tutorial as a github gist](https://gist.github.com/jphastings/178487). If you feel like getting some rather hacky geotagging features in your tumblog, this is one way to do it with google maps and plenty of time!
|
||||
After making a [formal request for geotagging features](http://web.archive.org/web/20090819092856/http://getsatisfaction.com:80/tumblr/topics/geotagging_of_individual_posts)[^1] on their GetSatisfaction pages, someone asked me how I got it done, so I created a (very sloppy) [tutorial as a github gist](https://gist.github.com/jphastings/178487). If you feel like getting some rather hacky geotagging features in your tumblog, this is one way to do it with google maps and plenty of time!
|
||||
|
||||
The Cons:
|
||||
|
||||
|
|
@ -22,4 +22,4 @@ The Cons:
|
|||
|
||||
And yes, Japan was amazing.
|
||||
|
||||
[^1]: Import note: GetSatisfaction has [gone offline](https://en.wikipedia.org/wiki/Get_Satisfaction), so this forml request has succumbed to link rot.
|
||||
[^1]: Import note: GetSatisfaction has [gone offline](https://en.wikipedia.org/wiki/Get_Satisfaction), so this formal request has succumbed to link rot.
|
||||
|
|
|
|||
|
|
@ -11,4 +11,4 @@ tags:
|
|||
|
||||
> Try another pleasure, such as putting your underwear in the fridge when the weather is hot.
|
||||
>
|
||||
> [Rich Jackson](https://twitter.com/RichardJJ/statuses/1929169703)
|
||||
> Rich Jackson _on Twitter_
|
||||
|
|
|
|||
|
|
@ -24,11 +24,11 @@ Well, its been a few months since I posted last - the genuine joy of interesting
|
|||
Voici [DAAPlaydar](https://github.com/jphastings/DAAPlaydar): a script that will resolve playlists of yours (using playdar) and make them available to you via DAAP share. A very cool concept (even if I say so myself!) but it falls short because iTunes is very picky about the DAAP servers it talks to, Songbird works well though :) I hope to be ablet o work a bit more on this in the near future - if you have any expertise with DAAP, you know who to get in touch with!
|
||||
|
||||
- In order to get DAAPlaydar working I had to build a few libraries, one to decode Apple's DMAP object encoding method (now a ruby gem on gemcutter called (drumroll please) [dmap](https://github.com/jphastings/dmap) - woop! There's also [PlaydARR](https://github.com/jphastings/PlaydARR), a ruby library for interacting with the Playdar server (also now a gem on gemcutter). So named because [pirates help combat global warming](https://en.wikipedia.org/wiki/Flying_Spaghetti_Monster#Pirates_and_global_warming). True story.
|
||||
- My dashing alter ego [Cy Densham](https://twitter.com/CyDensham)[^1] has released some more poetry, your opinions are more than welcome.
|
||||
- My dashing alter ego [Cy Densham](https://www.byjp.me/poetry)[^1] has released some more poetry, your opinions are more than welcome.
|
||||
- At some point some of the many photos I took while traveling Japan will arrive on Flickr (I'm fighting with FlickrUpload for Aperture at the moment) some of[^2] [the photos are already up](https://www.flickr.com/photos/jphastings/albums/72157622516311575), and of course they're geotagged ~so you can just [browse to Japan in Flickr](https://www.flickr.com/photos/jphastings/map?&fLat=35.5322&fLon=136.2963&zl=12&order_by=recent) to see them~[^3].
|
||||
- I've also realized that one of the projects I enjoyed working on the most isn't mentioned on here! Shock horror. [irotoku](https://github.com/jphastings/irotoku) is a (very basic) way of hiding information in images - ie. Stenography - the implementation of the decoder I wrote in C here is quick enough that if you hide MP3 data in a (big!) image you can pipe directly from the image through irotoku to an MP3 player and listen to your heart's content. Good fun.
|
||||
- So that's pretty much all for now, Cy has some interesting ideas so there may some more stuff up here soon, but he might be pushed down by this newly inspired Physicist and such tedious things as job applications. Yay.
|
||||
|
||||
[^1]: Import note: Given the state of twitter here in 2023 this link to 'Cy Densham's Twitter account may not last long. Certainly the password to the account is long lost, and I've likely lost access to the email address behind it. Soon I'll get microblogging working on this blog, import those tweets to it, and swap the link over.
|
||||
[^1]: Import note: This was once a link to "Cy Densham"'s Twitter account, but here in 2023 Twitter is X and rapidly turning into a dungpile, so it's pointing back to poetry on this blog now.
|
||||
[^2]: All of
|
||||
[^3]: Apparently this no longer works?
|
||||
|
|
|
|||
|
|
@ -16,7 +16,7 @@ tags:
|
|||
|
||||
A note out there to anyone else having the same problem as me:
|
||||
|
||||
If you're trying to use [mini_magick](https://github.com/minimagick/minimagick) in a ruby application being run via [Passenger](https://www.phusionpassenger.com/) on Mac OS X Mountain Lion's Apache2, when you've installed imagemagick via [Homebrew](http://mxcl.github.com/homebrew) - _mouthful_ - then you may notice that that you get a Server Error when you try to process an image.
|
||||
If you're trying to use [mini_magick](https://github.com/minimagick/minimagick) in a ruby application being run via [Passenger](https://www.phusionpassenger.com/) on Mac OS X Mountain Lion's Apache2, when you've installed imagemagick via [Homebrew](https://brew.sh) - _mouthful_ - then you may notice that that you get a Server Error when you try to process an image.
|
||||
|
||||
This may be because the `PATH` variable Apache is supplying to your ruby instance doesn't have `/usr/local/bin` in it, which is where homebrew installs to.
|
||||
|
||||
|
|
|
|||
|
|
@ -18,7 +18,7 @@ So if you feel like listening to music from XFM, Radio 1, Kerrang! or NME then y
|
|||
|
||||
* [Download](http://playdar.org/download) and install the (frankly epic) Playdar service.
|
||||
|
||||
* [Browse to playgrub.com](https://www.playgrub.com) and install [the bookmarklet](javascript:(function(){%20host='http://www.playgrub.com/js/';%20_my_script=document.createElement('SCRIPT');%20_my_script.type='text/javascript';%20_my_script.src=host+'playgrub_bookmarklet.js?';%20document.getElementsByTagName('head')[0].appendChild(_my_script);%20})(); "This bookmarklet good as of 2009-12-28")[^2]
|
||||
* [Browse to playgrub.com](http://web.archive.org/web/20091102074333/http://www.playgrub.com/) and install [the bookmarklet](javascript:(function(){%20host='http://www.playgrub.com/js/';%20_my_script=document.createElement('SCRIPT');%20_my_script.type='text/javascript';%20_my_script.src=host+'playgrub_bookmarklet.js?';%20document.getElementsByTagName('head')[0].appendChild(_my_script);%20})(); "This bookmarklet good as of 2009-12-28")[^2]
|
||||
|
||||
* Go and visit your favourite radio playlist or musical listing and hit 'Grub'!
|
||||
|
||||
|
|
|
|||
|
|
@ -13,7 +13,7 @@ tags:
|
|||
|
||||
> I had an idea last night, I'm going to sketch it out here it may turn into more than an idea at some point!
|
||||
|
||||
If you're a hobby podcaster or webradio DJ then you may find yourself limited to the songs you can use without having to hunt down a licence or permission. Despite the fact that its [easier all the time](http://www.ukpa.info/2008/08/22/the-new-mcps-prs-podcast-license/) it could be time consuming enough to make it not worth while.
|
||||
If you're a hobby podcaster or webradio DJ then you may find yourself limited to the songs you can use without having to hunt down a licence or permission. Despite the fact that its [easier all the time](http://web.archive.org/web/20090930082731/http://www.ukpa.info:80/2008/08/22/the-new-mcps-prs-podcast-license/) it could be time consuming enough to make it not worth while.
|
||||
|
||||
Having become quite interested in [Playdar](https://playdar.org) I came up with an idea for making podcasting even the most protected of tracks (say the [Happy Birthday song](http://www.unhappybirthday.com/)[^1]) totally legal.
|
||||
|
||||
|
|
|
|||
|
|
@ -11,7 +11,7 @@ tags:
|
|||
- from-tumblr
|
||||
---
|
||||
|
||||
I had some time to kill on a lazy summer's day and I noticed that splendid chap [Max](http://twitter.com/mxcl), had [posed a question](http://twitter.com/mxcl/status/16838493726) to the lazy web:
|
||||
I had some time to kill on a lazy summer's day and I noticed that splendid chap [Max](https://mxcl.dev/), had posed a question to the lazy web:
|
||||
|
||||
> Is there a tool for measuring profanity in code-bases? If not, can someone write it and call it "pottymouth"? Ta.
|
||||
|
||||
|
|
|
|||
|
|
@ -12,7 +12,7 @@ tags:
|
|||
- from-tumblr
|
||||
---
|
||||
|
||||
When writing [a post](../how-developers-brains-work) the other day[^1], I wanted to be able to use the tumblr chat where the participants were twitter users. Tumblr doesn’t support HTML in chat usernames, so I wrote a tiny javascript chunk to automatically troll any elements you give it and replace `@twitter-username` with a link to their account. (You can see it in action on the aforementioned post[^2]) You can find the code in [this github gist](https://gist.github.com/jphastings/115054), all you need to do is link in [mootools](https://mootools.net) (you only need to have the selectors part available, for now) and this script in the head of your template like this:
|
||||
When writing [a post](/posts/how-developers-brains-work) the other day[^1], I wanted to be able to use the tumblr chat where the participants were twitter users. Tumblr doesn’t support HTML in chat usernames, so I wrote a tiny javascript chunk to automatically troll any elements you give it and replace `@twitter-username` with a link to their account. (You can see it in action on the aforementioned post[^2]) You can find the code in [this github gist](https://gist.github.com/jphastings/115054), all you need to do is link in [mootools](http://web.archive.org/web/20230812014508/https://mootools.net/) (you only need to have the selectors part available, for now) and this script in the head of your template like this:
|
||||
|
||||
```html
|
||||
<script type="text/javascript" src="mootools.js"></script>
|
||||
|
|
|
|||
|
|
@ -12,7 +12,7 @@ syndications:
|
|||
- https://medium.com/@jphastings/the-web-s-missing-communication-faculty-e2f910b908fa
|
||||
---
|
||||
|
||||
The internet can be seen as a mechanism for speeding up and broadening information transfer; Wikipedia shares [knowledge](https://en.wikipedia.org/wiki/User:Alan_Liefting/Essays/The_sum_of_all_human_knowledge), Newseum makes [local news global](http://www.newseum.org/todaysfrontpages/), Reddit, Twitter, Imgur and countless more give anyone access to subcultures, viewpoints and opinions from all over our planet—I don’t need to highlight why we’re calling this this [Information Age](http://www.sciencemuseum.org.uk/educators/plan_and_book_a_visit/things_to_do/galleries/information_age.aspx#content). All this is an extension of the human sharing processes that humans use in face-to-face communication, but I think there’s one facet which hasn’t quite made the jump to the internet yet.
|
||||
The internet can be seen as a mechanism for speeding up and broadening information transfer; Wikipedia shares [knowledge](https://en.wikipedia.org/wiki/User:Alan_Liefting/Essays/The_sum_of_all_human_knowledge), Newseum makes [local news global](http://www.newseum.org/todaysfrontpages/), Reddit, Twitter, Imgur and countless more give anyone access to subcultures, viewpoints and opinions from all over our planet—I don’t need to highlight why we’re calling this this [Information Age](http://web.archive.org/web/20151004040741/http://www.sciencemuseum.org.uk/educators/plan_and_book_a_visit/things_to_do/galleries/information_age.aspx). All this is an extension of the human sharing processes that humans use in face-to-face communication, but I think there’s one facet which hasn’t quite made the jump to the internet yet.
|
||||
|
||||
In person, assessing the believability of what you hear is intuitive, you might know the person and trust their opinions, or they could be a stranger and you’d be wary of what they have to say. Online, most communication is functionally anonymous, either because the other party is masking their identity, or because you’ve never met them and have no context for their existence despite knowing their (user)name. This, as well as the sheer quantity of knowledge available, makes it almost impossibly hard to fact-check or otherwise judge a source of information for believability in the long distance communication the internet enables.
|
||||
|
||||
|
|
@ -32,7 +32,7 @@ The advent of [hyperlinking](https://en.wikipedia.org/wiki/Hyperlink) and the we
|
|||
|
||||
So how would you build a framework for enhancing your ‘gut instinct’ for credence on the internet? Clearly the web already lets you research any topic in great depth if you need a deep understanding, but what about ‘at a glance’? And how would you allow for the often different and opposing views on whether something should be believed or not? A statement like “The Earth was formed 4,000 years ago” will be considered absolutely true in some circles and absolutely false in others.
|
||||
|
||||
Because I like thinking and creating, I’ve put together a prototype of a mechanism that allows this, I call it [Credence](http://getcredence.net/).
|
||||
Because I like thinking and creating, I’ve put together a prototype of a mechanism that allows this, I call it **Credence**.
|
||||
|
||||
Credence allows you to make assertions like this:
|
||||
|
||||
|
|
|
|||
|
|
@ -53,13 +53,13 @@ I believe that context is critical to everything in life. I’m sure there’s a
|
|||
|
||||
The only true way to build a shared context is to discuss things, often at length and sometimes without specific direction. Putting time aside to chat to your colleagues — from all over the business — will give you an idea of what’s important to them and how best to work with them.
|
||||
|
||||
“Naming things” is one of the [two hardest problems in computer science](https://twitter.com/codinghorror/status/506010907021828096), and naming them well is _critical_. One word can have many different meanings — some specific to our company — so when you commit words to lasting documentation or code make sure you choose your words carefully.
|
||||
“Naming things” is one of the [two hardest problems in computer science](http://web.archive.org/web/20230822235603/https://twitter.com/codinghorror/status/506010907021828096), and naming them well is _critical_. One word can have many different meanings — some specific to our company — so when you commit words to lasting documentation or code make sure you choose your words carefully.
|
||||
|
||||
As engineers we spend a lot of time doing this, even in something as transient as short-lived script variable names. You never know when someone else, or an older you, will need to understand what you were trying to do.
|
||||
|
||||
Making code “self” documenting is, for us, frequently the best form of documentation. The further an explanation gets away from the thing it’s documenting the less likely it is to be ‘in-sync’, and the more work the reader has to do to figure out what was meant.
|
||||
|
||||
Self-documenting code is incredibly useful, but when it comes to “best practice” we’ve found that a set of separate, community maintained [guidelines](http://deliveroo.engineering/guidelines/) makes for a great space to both discuss and refer to the approaches we take to common problems.
|
||||
Self-documenting code is incredibly useful, but when it comes to “best practice” we’ve found that a set of separate, community maintained [guidelines](http://web.archive.org/web/20170521072344/http://deliveroo.engineering:80/guidelines/) makes for a great space to both discuss and refer to the approaches we take to common problems.
|
||||
|
||||
We also structure our unit tests to demonstrate the specific cases we expect our code to be used in, and the expected outcome. This gives us a reliable shared basis for talking about our code.
|
||||
|
||||
|
|
|
|||
|
|
@ -15,11 +15,11 @@
|
|||
<h2>The Conclusion</h2>
|
||||
<embed class="svgex" src="prime.svg" type="image/svg+xml" frameborder="no" align="middle" width="860" height="500" id="sv"/>
|
||||
<div id="describe">
|
||||
<p>Project Prime is a collaborative artwork, initiated by <a href="http://twitter.com/CyDensham" target="twitter">Cy Densham</a> based on four of his <a href="https://www.byJP.me/poetry/" target="poetry">poems</a>, Chapters <a href="https://www.byjp.me/poetry/chapteri" target="poetry">I</a>, <a href="https://www.byjp.me/poetry/chapterii" target="poetry">II</a>, <a href="https://www.byjp.me/poetry/chapteriii" target="poetry">III</a> and <a href="https://www.byjp.me/poetry/chapteriv" target="poetry">IV</a>.</p>
|
||||
<p>Project Prime is a collaborative artwork, initiated by <a href="https://www.byjp.me/poetry" target="twitter">Cy Densham</a> based on four of his <a href="https://www.byJP.me/poetry/" target="poetry">poems</a>, Chapters <a href="https://www.byjp.me/poetry/chapter-i" target="poetry">I</a>, <a href="https://www.byjp.me/poetry/chapter-ii" target="poetry">II</a>, <a href="https://www.byjp.me/poetry/chapter-iii" target="poetry">III</a> and <a href="https://www.byjp.me/poetry/chapter-iv" target="poetry">IV</a>.</p>
|
||||
<p>Though they are, perhaps, uninspiring names they were chosen to allow readers (in particular the collaborative artists involved with this work) to form their own interpretations and impressions of the short collections of words within. Over the course of several weeks <strong>44</strong> people submitted a little information about themselves and their impressions of each of the pieces.</p>
|
||||
<p>Each person is represented in the artwork below by a coloured shape. Each shape's centre is placed on the canvas according to their age, with older people towards the right, younger to the left, the first people to collaborate nearer the bottom and the last nearer the top. The colour of the shape shows their preference towards each poem - the stronger the primary colour the more they liked that poem; red for Chapter II, green for Chapter III and blue for Chapter IV. Chapter I has is preference shown by transparency, the faster a shape pulses the more it was liked by the person it represents.</p>
|
||||
|
||||
<p>If you enjoy our work, share it and by all means contact me directly <a href="http://twitter.com/CyDensham" target="twitter">on twitter</a>, I'll be sure to 'retweet' your thoughts to anyone following me.</a></p>
|
||||
<p>If you enjoy our work, share it and by all means contact me directly <a href="https://www.byjp.me/poetry" target="twitter">on twitter</a>, I'll be sure to 'retweet' your thoughts to anyone following me.</a></p>
|
||||
|
||||
</div>
|
||||
</div>
|
||||
|
|
|
|||
Loading…
Reference in a new issue