“The ideal README is as short as it can be without being any shorter. Detailed documentation is good — make separate pages for it! — but keep your README succinct.” Node-centric, but the wisdom can be applied to pretty much any language / ecosystem. Link.
federated from Pinboard
A couple of weeks back, I subtly released Jankteki 0.6, which brought with it a refactor, lots of instability, and a feature that I’m hoping will be useful to people that aren’t me: The ability to add user notes against a user on jinteki.net.
Have you ever added a friend on Jinteki and forgot why they’re there? Me too – now I don’t need to, I can add user notes. Here’s a demo of it in action:
As I said, it has brought with it a bit of instability, and it is still in its early days in terms of quality / interaction / etc. But I need to tell people about it, in case they think the software got buggier for no reason whatsoever. I also think it’s a nice basis to build further features upon, and want to get input on it as early as possible.
One of the silver linings of the breakages is that it has led to me tightening things up in the code base.
Scarily enough, there are now just shy of 1500 users of this extension now, and when it breaks, it seems to annoy people. Going below 5 stars in the chrome extension store gave me some real impetus to try to stop that all happening again.
There are now some tests, and build scripts, and stuff that makes it look like I have any idea what I’m doing, to aid with keeping things stable in the future.
If however, something does get through these very porous nets – head on over to http://github.com/simons/jankteki to raise a bug. There’s a proper readme over there now too, so that should give you all of the information needed to get problems sorted in good time.
And if you have no idea what I am talking about, but do know what Android: Netrunner and jinteki.net are, download the Jankteki extension from the Chrome webstore. It’s pretty useful.
The more eager eyed Jankteki users may have noticed the latest release. It consists of a small in-game ‘fixes’ panel where you can manually manipulate the game state without having to look up relatively arcane chat commands.
Here’s a video of this feature in action:
It’s the first interaction I’ve done with the game directly and was made pretty simple through Clojurescript / Om’s use of websockets. It was my first experience inspecting websocket frames through the Chrome Dev tools, and it must be said – I found it to be an utter joy. Hopefully this leaves room for other enhancements down the way.
In the meantime, the next slate of work is going to be around creating a fuller user-model – adding notes, annotations, that sort of thing. Maybe even the dreaded “shitlist” feature. More information on all of this / priorities etc can be found on my Trello roadmap
In the past year or so, the collectible card game, Android: Netrunner has just about taken over my life. I won’t go on about why here, but it’s great. You should play it.
One of the more popular ways of playing it is through an online open-source implementation, jinteki.net. Legally dubious, it’s a Clojure implementation of the game – involving a huge percentage of cards, providing automations for 1000s of rules and all sorts of interactions / exceptions / custom rulings. Needless to say, it’s a fantastic amount of effort being provided by a dedicated team of developers, led by Minh Tran.
As the game and platform have become more popular, the types of players on there have varied with it. More players is good, it’s more people and decks to play against. It also comes with a trolly underbelly. Ragequits and rude users used to be unheard of there, they’re now part of the landscape.
Navigating all of this can be frustrating at times. Whether it’s remembering who the bad players are, or looking for people you know to play (or watch play) – these are currently hard to do. And improving the platform at the same time as keeping up to date with card implementations is a slow process. So I built myself a tool – Jankteki, a chrome extension for jinteki.net.
I intend for it to be a suite of tools to make using jinteki.net a slightly better experience day-to-day. It’s called Jankteki, because the hacky nature of building features over a ReactJS UI makes for flickers, jank, and breakages all over the place. So use it at your own risk.
The only real feature currently implemented is friends, which you can see wonderfully narrated here:
Why not raise a PR?
I know a bit of Clojure, and I enjoy writing it – but I’m nowhere near being able to contribute to a project the scale of Jinteki. There’s also the fact that my roadmap might not correlate with the Jinteki roadmap, I have features planned to scratch my itch that might be a year or two away from being even discussed in the main repo.
Some of them might not even be the job of the main webapp.
And what is this roadmap?
The full in-progress roadmap can be seen on a Trello board I am working from. But here’s a quick overview (it is completely subject to change):
- I’m aiming to put in a toolbar for running console commands (deal net damage, remove counters, etc) in order that you don’t have to remember syntax or look it up every time the game state needs manually adjusting.
- Notes for users. I constantly forget who people are from their usernames, a notes field could track that. It could be used to remember what type of decks they play. Or even to note who “gg”s before they leave (this is disproportionately important to me).
- The killer feature I’ve talked about, but not implemented yet (I half implemented it and took it out), is some sort of bad-players list. Just a way of flagging a user visually as someone to avoid in the future. It would purely be a personal shit-list, not like a communal feature – both by design, and cos it’s outside the scope of this thing.
- Game log recording / analysis. This sits in the “I’m unsure this would ever become a feature of the webapp” column. But I love the idea of logging wins and losses vs opponents, factions – methods of losing – and obviously which deck you were playing as at the time. Just as a way of tracking how you’re getting on and what works.
Building this plugin hasn’t been smooth. React’s virtual DOM makes it a nightmare to manipulate constantly changing elements – an element that indicated a friend two seconds ago may contain something else completely.
This plugin is also tightly coupled to class and element names in the jinteki.net codebase, if they change something, we’re always going to be playing catch-up. I’m ok with that. I don’t know how Minh will react to the existence of this (or if he’ll even care :D), but I hope Jankteki will benefit the Jinteki.net team in both taking the demand for certain features, and also proving and disproving features before implementing them.
Links for Jankteki
So where to get it?:
And yes – it’s a bit rubbish at the mo, but it proves a concept, so please be open minded with it. There are bugs with pinned friends not showing when navigating to pages, if you have issues, try going directly to http://jinteki.net/play or just refreshing the page – I am actively working on that.
Also – things are liable to break, pre version 1 (I don’t know what that will look like), I’m pushing to the web store as often as I’m adding features / fixing bugs. So prepare to be annoyed.
I’m not going to blather too much on here. Just dot down some bullet points to update you and remind my future self how things are going:
- My running streak is still alive, it hit 3 years as of yesterday. My real celebration happened in October, when I passed day 1024:
Today, I unlocked 11th bit: 1024 consecutive days running. To celebrate I ran long way home (10.24 miles). Dat pace. pic.twitter.com/p2qUMIRetw— Simon's Calf (@simonscarfe) October 21, 2014
- Weight is once again well up. This is a problem I continue to have despite putting in 40-60 miles most weeks. It’s the result of a bad diet, a complete lack of discipline, and the high mileage.
- I read “Racing Weight: How to Get Lean for Peak Performance“* over the Christmas break. It has given me a lot of ideas about how to lose weight while doing my lengthy commute runs.
- One of the things it recommends is to track body fat rather than weight. So I got myself a set of Omron BF508 Body Composition and Body Fat Monitor Bathroom Scales* in the Amazon Boxing Day sales. I don’t know how they compare to “accurate” methods of measurement. It is a baseline from which to track my progress.
- According to the book, I’m in the 5th percentile of “athletes” of my age. I’m not an athlete, but it gives me an idea of what other people doing a similar workload to me carry. It also tells me that maybe I should look after myself better.
- Currently, I’ve marked the book as 3 stars on Goodreads. I shall revisit this in about 6 months and review it based on my results.
- I once again intend to update this thing more, as a blog that reflects me and where I am right now. Expect more running, more tech stuff, as well as some reflection on the things I have consumed. Revisiting that stuff is both rewarding and useful. I should do it more.
* I’ve stuck some affiliate links in there. Delete them if you care.
In personal finance, they often talk about ‘passive income’ and making your money ‘work harder for you‘. The idea being that you set-up a side project which starts trickling in a bit of surplus cash each month without having to do any extra work. It’s not something I do – most of the traditional ways seem a bit leechy and middle-manny for my liking. But even so, it is something that has always stuck in the back of my head.
Before I started streak running, 20 miles in a week was a great week for me. When I started doing 2 miles a day, I realised that I was getting in 14 easy miles without even trying. It reminded me of this passive finance idea. Passive mileage, if you will.
Last year, about 15 months into my streak, I moved to a house which was 5 and a half miles from work. My workplace provides showers, and so I started running in to work 2 days a week. My passive mileage had doubled.
Since then, I have gradually grown it, to the point where it’s not unusual for me to do 4-5 11 mile days on the bounce. I never intended for this to happen. I guess I just enjoy the commute – it’s as fast as public transport, cheaper, and it lets me indulge in hours upon hours of podcasts. Without going out of my way, my mileage now always breaks 30+ in a week
This doesn’t come without cost: I find eating well to be a challenge. There have been some weeks where, despite running 40+ miles, I’ve still managed to put on considerable weight. It’s tiring – I’m not sure that come Friday, I’m that pleasant to be around (insert a joke here about Friday being no exception). And it limits what you can run at the weekend. Thanks to passive mileage, I no longer have a Long Slow Distance Run. It would be a foolish recipe for injury if I didn’t rest up at the weekend.
But these are all things I’m working on. I’m measuring calories, and the weight is coming down. And I’m not currently training for anything. Needless to say, when I do train for a race again (I have my eye on a couple), this routine will all shift up.
Is passive mileage for everyone? Goodness, no. But it works for me, I mean – it doesn’t make me run fast, it doesn’t make me run particularly far, but it does allow me to run a lot. All without having to adjust my normal routine. And that’s why I like it.
I have had a post in draft since the beginning of the year, all about analysing my running streak as it stands. It picks out the miles I’ve done on it, average mile per run, distributions of milages, that sort of thing. Loads of self indulgent wank, that I felt at the time was “interesting”. Reading back on it now, it’s anything but.
In the middle of composing it (according to WordPress, I last touched it 11th February), I stopped measuring pretty much everything. I just got sick. Sick of weighing myself. Timing myself. Caring how far I had ran.
Measuring shit definitely works – I have no doubt of that. Anytime I’ve measured something, I have consistently optimised towards that metric – be it weight, speed, bacon eaten. In the case of weight, the opposite also holds true – I put on about 2kg in the month following my “sick of this shit” tantrum.
I was still exercising plenty – running at least 30 miles per week in that time, in addition to a couple of BJJ sessions. I just happen to have a better appetite.
All of this has made me think – is the value in the “quantified self” movement that people are explicitly going out of their way to measure and observe things that they would like to optimise? If we were able to get these metrics at any point without installing apps, or buying devices, or just plain writing them in spreadsheets, would this value disappear? Beyond being able to say “oh, I’m fat because I do little exercise and eat too many calories” (unlike all of those other fat people), why is a graph such a motivator?
I understand that the whole thing is more faceted than “MAKE THE GRAPH GO BIGGER” – there is accountability (to both the tech and other people), QS allows you to find patterns and correlations in the data that you might not have otherwise noticed, as well as a billion other reasons for its existence. It can’t be a coincidence that the latest Apple and Samsung products have a “health & fitness” spin on them.
I should note here that I’ve not touched this post since March. The above feelings remain true, but I am a flip-flopper. Picking it back up again in mid-June:
Since I started writing this post, I am once again measuring stuff. I want to lose weight (again) because the metaphorical yoyo has retouched the hand. I’m measuring my calorie intake on MyFitnessPal, and that hooks up passively with Endomondo to measure what I’m burning.
But my reservations about QS and “Quantified Fatigue” stand – measuring everything explicitly is too difficult, and I’m concerned about how useful implicit & ubiquitous measurement would be after the fact. There’s no real conclusion here – implicit & ubiquitous doesn’t exist, it remains to see how iOS8 & the S5 will perform in this area, and I’m likely to lose a bunch of weight, get bored and put it all back on again. I just figured it was about time I did some writing here, terrible or otherwise.