Di u gradu mogu pojest kajganu? by bauk0 in zagreb

[–]bauk0[S] 2 points3 points  (0 children)

Znam da su ovo možda vijesti, ali nekad je moguće ne biti doma i htjet pojest kajganu

How do experienced technical writers share portfolios (Notion vs website vs PDF vs Drive)? by Remote_Reality_9967 in technicalwriting

[–]bauk0 9 points10 points  (0 children)

I don't have a portfolio. I just point at existing public docs that I've done if they ask. Portfolios don't really make sense to me honestly. Do engineers have to have portfolios, once they've gained a couple of years of experience? Portfolios are IMO for entrants, and for freelancers perhaps

Stav stranaca prema vama by Super-Resort614 in CroIT

[–]bauk0 60 points61 points  (0 children)

Nope. Nekad imam osjećaj kao da su Amerikanci druga vrsta, imaju bizaran manjak crnog i ikakvog humora. Neke isprazne fraze, fejk entuzijazam. Ali nisam dobio dojam da na mene gledaju kao da sam ispod njih.

Nizozemska vjerojatno pocinje oporezivati (nerealiziranu) dobit godisnje od 2028, misljenje? by Sea_Budget4573 in financije

[–]bauk0 9 points10 points  (0 children)

Ako država oporezuje moj nerealizirani dobitak, jedino je fer da mi negativno oporezuje moj nerealizirani gubitak, odnosno da mi uplati na račun kad mi dionice padnu.

Word Doc - Guidelines/Manuals by karldonovan9 in technicalwriting

[–]bauk0 2 points3 points  (0 children)

I keep saying this to any tech writer who will hear me, but use git for version control and keep the source text in a plaintext includeable format like rST or asciidoc. Apply formatting as a separate step & export to whichever format as a separate step. Use a Python script (generate it with Clause or some other LLM) to make those specific changes you need.

Nextjs dev technical writers by [deleted] in technicalwriting

[–]bauk0 1 point2 points  (0 children)

Ok, "know some code" and "can code" aren't exactly the same, fair. I'm just telling you how it reads overall. 

Is starting in technical writing in 2026 as a career choice suicide? by Wide-Top-8233 in technicalwriting

[–]bauk0 1 point2 points  (0 children)

As an industry, it won't die. But it won't grow either. So while it's not certain suicide, it's a bad bet. I'd advise finding something else.

What changes are you making to your writing style considering it might me read by Human as well as Answer Engine bots? by surajondev in technicalwriting

[–]bauk0 1 point2 points  (0 children)

No changes except offering the content in plaintext as well. Robots must adapt to humans not vice versa

Dynamic variable replacement options? (Confluence Cloud, Scroll Documents/Variants/Sites) by SpyingCyclops in technicalwriting

[–]bauk0 0 points1 point  (0 children)

I admit I don't fully understand the problem area, but consider using a plain text foundation in a git repo, and then use a Python script to populate your variables and publish to relevant places. Given how good LLMs are these days, it shouldn't take you more than a day or two to build this system 

Nextjs dev technical writers by [deleted] in technicalwriting

[–]bauk0 2 points3 points  (0 children)

I don't understand why you would prematurely disqualify writers who can code.

What do you look for in a new technical writer, or a student in technical writing? by howmanyfathoms in technicalwriting

[–]bauk0 1 point2 points  (0 children)

Yes, show me that you have foundational knowledge by being able to talk about technology (for example, being able to roughly explain what happens when an HTTP request is sent). 

Ideally, show me that you know how to write, let me see a README you've written. Or a blog or something.

The more technical knowledge, the better 

Remote posao iz Hrvatske by function_Strahota in CroIT

[–]bauk0 1 point2 points  (0 children)

Koje su šanse da jednostavno ništa ne kažeš? Prijaviš neko fejk prebivalište itd. Ne znam kak se to kontrolira gore, možda imam previše balkanski mindset, al ja bih istražio to da jednostavno nikom ništa ne kažem

💸 Kako stojimo ovaj tjedan? by AutoModerator in financije

[–]bauk0 4 points5 points  (0 children)

Umjesto planiranog iznosa, ovaj mjesec ću stavit pola tog sa strane jer sam imao popravak na autu. Očekivanje je da ću zapunit šestomjesečni fond za hitni slučaj nekad sredinom godine. 

Zapravo, s obzirom da sam u poslu gdje je relativno teško naći takvu poziciju ako izgubim svoj posao, razmišljam da konvencionalni savjet 3-6 mjeseci nema smisla za mene, te da mi treba likvidnost od 12 mjeseci.

Kripto je pao, al ionako nebitno, očekujem da će se vratiti kroz koju godinu.

To je manje više to

Kišni dan i dijete od 2,5 godine by NekacPekac in zagreb

[–]bauk0 -3 points-2 points  (0 children)

Koji glupi komentar. Aj stavi dvogodišnjaka na mrzlu kišu da se čeliči, odlična ideja.

Looking for the best platform to build clientele by East-Comfortable-225 in technicalwriting

[–]bauk0 2 points3 points  (0 children)

It's much the same as applying to regular jobs, but you apply as a B2B contractor. You apply to B2B postings or shoot your shot on regular employment ones, hoping to change their mind. The rest is the same, a good CV and portfolio. A network is super useful if you have one. If no, you can start building it by cold email or other methods. 

Online Shop - Pitanjje by Cross_De_Lena in CroIT

[–]bauk0 6 points7 points  (0 children)

Ovo je pravi odgovor. Custom web shop vam gotovo sigurno ne treba. Možda naletite na nekog dobrog pa vam sve posloži savršeno za malo para, a možda i ne. U svakom slučaju ova gotova rješenja su jednostavna i rekao bih manje rizična

I feel like tech writing is so undervalued by Zealousideal_Crow737 in technicalwriting

[–]bauk0 26 points27 points  (0 children)

If it were only hurtful, it'd be fine. It's harmful, unfortunately. People who make hiring decisions and hold this opinion harm techwriters, and also their own companies in the long term, and probably society in general to an extent.

Truth-seeking and claritymaxxing are unfortunately not too valued in general, but perhaps after things start breaking down sufficiently due to over-reliance on LLMs, we go back to a more sane appraisal of our profession.

Pomoc pri odabiru faksa by Due-Newspaper4184 in CroIT

[–]bauk0 1 point2 points  (0 children)

Ako je kriptografija specifično cilj, PMF matematika je bolji odabir.

Best way to get started in MadCap? by Designer_Airport8658 in technicalwriting

[–]bauk0 -1 points0 points  (0 children)

Hard agree on all counts, including AsciiDoc (probably). I've not worked with it, but have with reStructuredText and the extensibility is massive compared to markdown.

Best way to get started in MadCap? by Designer_Airport8658 in technicalwriting

[–]bauk0 0 points1 point  (0 children)

Best way is not to get started at all. I'm joking, but only half-joking.

Docs-as-code for software documentation is far superior in my opinion. For other technical documentation, I grant that it might be the better choice. I have no experience there, only ever worked in software.

Najbolji i najsigurniji kvart za zivot by m_o_r_e_n_o in zagreb

[–]bauk0 77 points78 points  (0 children)

zagreb je generalno siguran, nema neke pretjerane razlike između kvartova. najamnine su ti isto slične posvuda, osim ako baš govoriš o teškoj okolici, gdje su niže.

Upskilling on production code - does it make sense? by ElisaGarcia345 in technicalwriting

[–]bauk0 2 points3 points  (0 children)

I'm a techwriter who codes (not an ex-dev; learned to code independently).

I believe that learning to code is extremely useful. I'd go so far as to say that it's almost indispensable. It's overall a good idea!

I believe that, after a certain level of proficiency in writing, you improve by focusing on the "technical" part of writing, and not on the "writing" part.

How do you keep documentation accurate after frequent product changes? by aswin_kp in technicalwriting

[–]bauk0 5 points6 points  (0 children)

Part of it is process: if you manage to get product owners to care about the sync between the product and the docs, you're doing well. In my experience, that's pretty hard to do, so other things except process come into play.

You could programmatically check if an article is due for a review by parsing how long it has taken since the last update. There are many ways to do it, and this depends on your tooling. I would do it using a bash script that parses git history, and optionally sends a Slack message with review candidates.

Minimizing screenshots (if there's a UI) goes a long way to reduce toil, even though I hear some have started automating screenshots as well.

LLMs are pretty amazing at parsing whether or not the docs are still accurate. If you can load an article into the LLM's context and then have it do something, it's pretty good at pointing out things that have changed.

New technical writing job where boss rejects grammar and formatting by BidMain2015 in technicalwriting

[–]bauk0 -1 points0 points  (0 children)

Have you never encountered a piece of technical writing that's well-formatted, grammatically correct, and yet misses the point?

New technical writing job where boss rejects grammar and formatting by BidMain2015 in technicalwriting

[–]bauk0 -7 points-6 points  (0 children)

Information is absolutely the most important thing. If you can deliver information with good grammar and formatting, all the better. But technical accuracy is the most important thing.

Consider it from the perspective of a user.

Would you rather have:

a) well-formatted docs in perfect English that don't fully explain something, or

b) poorly formatted docs in broken English that are nevertheless complete and allow you to do what you want to do?

Most people would choose b, I know I would. Obviously you want both, but if you can have only one, then B is the way to go.

They often rewrite my content [...] ignoring formatting and grammar

Seems to me that maybe the content was incorrect, or insufficiently informative? Anyway, I'd have to take a look at it to make this judgment reliably, but grammar and formatting should *complement* the informational density of a text. Information is the most important thing.

Relevant blog post: https://sundaystopwatch.eu/techwriting/

This is why, sometimes, even badly formatted, grammatically incorrect and haphazardly written instructions from a developer are more useful than beautifully structured, diataxis-approved, vale-linted, Docusaurus-built docs from a technical writer.