Sky SchubertJun 14

Edit: Update: y'all are amazing and I'm talking to several people now! So while I appreciate more emails, as y'all are lovely, I'm probably good!

Hi internet friends. I have a bit of a weird request.

I am looking for a German technical writer/translator who knows their Web Development basics and would be able to translate @bw 's excellent https://htmlforpeople.com into German (casual edition). Here are some of the facts:

  • All the markdown files are ~31k words in total.
  • I will pay for your time, I don't expect free labor. However, that also means you need to be able to send me an actual invoice ("me" being a German legal entity with a business license who just so happened to get frequently audited by the tax office).
  • The contents will be available publicly to everyone under the same original license. My goal is just to make that content available to German speakers. I'm not entirely sure if getting paid for a translation is a violation of the CC's Non-Commercial clause, so I checked with Blake before posting this and he's fine with me doing this (thanks again!)
  • I will host the contents, you don't need to worry about any of that.

If that's something you can help out with, please say hi via email to [email protected]. And if you know someone who you think would be a great fit, feel free to forward this post!

 

Oh, and also: This post is only applicable to you if you are a human and you will use human translation skills and your human brain to translate the text with the love and attention it deserves. If you want to pitch me using an LLM for the translation, I will block you. Sadly, this also means I can only consider working with you if you have a public website or profile or anything that demonstrates me you actually do technical writing stuff, because I really don't want to pay someone just to throw the text into an LLM. If you think you could scam me into paying you to then just use an LLM, you will learn that I have a less-friendly personality, too. Don't be a jerk, please.

HTML for People

HTML isn't only for people working in the tech field. It's for everyone. Learn how to make a website from scratch in this beginner friendly web book.

Show threadleyrerJun 14

@sky @bw You lost me at "Download Microsoft Visual Studio Code", sorry. Good luck.

(yes, I understand why it's in there, I teach HTML since the 1990ties. Still ...)

Show threadBlake Watson Jun 14

@leyrer @sky lol, in my defense when I originally wrote it they weren't calling it an "AI editor."

Out of curiosity, what editors would you recommend to beginners? My requirement would be that it's easily downloadable from the web.

Show threadleyrerJun 14

@bw @sky Again, I understand where you come/came from with Microsoft ̶V̶i̶s̶u̶a̶l̶ ̶S̶t̶u̶d̶i̶o̶ ̶C̶o̶d̶e̶ Copilot :D

As a vim user, I am opinionated. ;)
But gvim/vim/vi or Emacs are not the right options :D

Sublime, Atom or VSCodium come to mind.

Show threadBlake Watson Jun 15

@leyrer @sky yeah, I was thinking maybe VSCodeium, although I just downloaded it and found it to be pretty laggy. Could just be an issue on my machine. Atom has been sunsetted. Sublime is pretty great, but I think beginners would probably struggle a bit since the sidebar isn't very interactive.

For now I can't really think of anything better. I do have limits though. If VS Code gets to the point where it's pushing AI chat interfaces in a way that makes it hard to get to a regular code editor, then I probably will change my recommendation.

Show threadRemco WesselsJun 15

@bw @leyrer @sky I recently went from VS Code to VSCodium and works like a charm.

That said, I can imagine that VS Code, CSCodium...but also vim or Sublime are a bit overwhelming if you have no develop history.

Maybe something like Notepad++ with 1 or 2 plugins might have a less steep learning curve?

Love the site btw, might gonna tip some people as I got (as a front-end dev) a lot of I-try-it-myself conversations.

Show threadleyrerJun 15

@remcow @bw @sky remco, vim is DEFINITELY not an option here :D
And the requirement is Win/Mac/Linux. So Notepad++ is unfortunately also out.

Personally, I would go with "use the text editor that comes with your OS", but that would handicap windows users quite heavily. :D

Show threadRemco Wessels

@leyrer @bw @sky A well, every sane Windows user knows not to use a less as possible what comes with the OS.

So adjust it to "use the text editor that comes with your OS or Notepad++"

As a gamer I always stayed with Windows. That and to lazy to make a dual boot. 😏

Jun 15 at 8:20amWeb
Show threadleyrerJun 15
@remcow @bw @sky your nerd perspective is not helping the users, this guide wants to address.
Show threadRemco WesselsJun 15

@leyrer @bw @sky Euh, it's my not-nerd talking right now, haha.

Thinking from a fresh non dev perspective, reacting to your 'You lost me at "Download Microsoft Visual Studio Code", sorry. Good luck.'

In the mean time I started reading the book and see it already start with just a simple text editor.

So I limit my 2 cent to chose VSCodium rather then VS Code.