KBD.NEWS MK Advent Calendar — guidelines for authors
Mixed format: Advent calendar, yearbook. To be published in December, 2024.
The KBD.NEWS Advent Calendar is a series of longer format articles revealed one by one on kbd.news in December.
Key info
- Deadline: End of November, early December.
- Character count: no hard cap (maybe 10-15K chars)
I will reach out to some renowned members of the keyboard community (the maker, creative, not-so-consumer side of the hobby), but feel free to contact me if you have an idea for an article and would like to contribute.
(Yes, these advent calendars have been a tradition in the Japanese DIY keyboard community for years. I'm about to shamelessly copy the format because it's awesome -- and take it a step further! :D)
Contents
- What to write about?
- Deadline
- Length, caracter count
- Checklist
- Formatting tips
- Nice-to-have elements
- Hosting
- Contact
- Examples
What to write about?
I may discuss this with you one by one, but there are some well-established genres, typical article structures in these calendars:
- A - Wrapping up ones whole year — kind of a journal, covering many projects, but less detailed.
- B - Introducing a specific project (in detail) — It can be a hardware or software project, experiences with manufacturing, bringing a product to the market, etc.
- C - Guide, tutorial — Covering a specific topic, e.g. using a specific software, component, ergonomics, etc.
- MIX - And some write-ups blur the lines between these categories.
Timetable and deadlines
The deadline to submit your article is: end of November, 2024.
Length, character count
There's no restriction for the length of the calendar posts, write as much as you like. However, keep in mind that people will actually have to read your masterpiece. ;)
Checklist
- Title - Max 50 chars, sweet spot: 33. E.g. "Summing up one year of kbd.news"
- Lead - A short (sweet spot: 130-160 chars) one-sentence intro for the front page, appearing at the top of the article as well. E.g. "Tamas Dovenyi, the guy running kbd.news, sums up this year's events touching on a wide range of topics from new features and major milestones to visitor stats."
- Cover image (front page and top of article). 1200px width is enough. 8:6, 16:9 aspect ratio, or anything in between.
- Intro - Make sure you introduce yourself at the beginning of the article. For those who are new to the hobby or live under a rock. ;)
- Your keyboard's specs: Close the article with the short specs of the setup it was written on. E.g.: I typed this article on my Azimuth, a self-designed unibody split, with Momoka Frog switches, MT3 Susuwatari keycaps, and the hallmark six encoders I never touch. :D And a custom logical layout. The low-pro thumb keys are vanilla Choc Browns with CFX caps. Links are OK, as well as a photo if you'd like.
- Author data sheet (public):
Feel free to skip any fields or the whole thing altogether. Appears at the end of your article or as box copy/panel in the pdf version. Example:
Name (age) Tamas Dovenyi (45) Handle dovenyi Location Debrecen, Hungary Description DIY keyboard content aggregator Occupation researcher, developer Joined (the hobby) 2018 Niche monoblock splits, vintage collector, kbd.news Favorite switch(es) Momoka Frogs, Kailh This-Is-Plastic Favorite keycap profile(s) MT3, MDA Other hobbies guitars, drums, speedcubing, Japanese Links (blog, social media) https://kbd.news
https://twitter.com/KbdNewsAnd feel free to include other categories like favorite movie/book/snack/drink/food, etc.
Formatting tips
- Last time, most authors preferred Google Docs. I don't really care, plain text is perfect too.
- Feel free to use markdown for links and basic formatting (optional).
- Don't use nested lists please, they look ugly.
- Use photos, illustrations, subheadings, quotes, etc. to break the wall of text.
- Most readers are non-native speakers. You don't have to give up on your style or oversimplify things, but e.g. shorter paragraphs help a lot.
Nice-to-have elements
References:
References to other projects/community members, possibly to other authors of this special issue (see above).
Preface — I'll take care of this:
Hosting
I prefer to host your articles on kbd.news. (I have no idea how I could do all the integration if you'd insist on hosting these write-ups on your own blog or various other platforms.)
In addition, I'd be happy to take care of all the formatting, timing, crosslinking, etc.
Contact
If you'd like to participate, just get back to me with your topic idea and maybe title (can be changed later).
I'm Tamas Dovenyi, my email is info at golem dot hu, or dovenyi#4481 (Discord), u/dovenyi (Reddit, Keebtalk, GH, Deskthority, etc.), @KbdNews on Twitter.
Examples
Finally, check out last year's calendar for examples, as well as previous Japanese calendars (1 & 2). Here are some posts grouped by the genres mentioned above.
Chrome/Google Translate works surprisingly well sometimes (and not at all in some other cases):
A - Wrap-ups, Journals
- Matt3o: Designing Keycaps for Fun and Profit
- Ben Vallack: Falling Down The Rabbit Hole
- Joe Scotto: The Handwiring Guy
B - Projects
- Stephen Cheng: Glove80 — Rethinking split contoured ergonomic keyboard
- Peter Lyons: Squeezebox Scorecard
- Making of the thinking face keycap
C - Tutorials, guides
- Pete Johanson: Designing for Wireless
- Sadek Baroudi: Keyboard Case Design
- Ergonomics of the Saddle keycaps
X - MIX
- MrZealot: Declarative keyboard design with Ergogen
- yfuku - projects, expansion plate system
- Ergonomic keyboard swamp
Which genre do you prefer?
If you have a general topic or tutorial in mind, get back to me so I can reserve that topic for you.
Cheers,
Tamás