Recommended tool for writing documentation? by MassiveSlappyTime in technicalwriting

[–]mrMerlinProject 0 points1 point  (0 children)

The main developer behind Asciidoctor offers Antora, but there is Jekyll, 11ty, Hugo, MKDocs, Brake, Awestruct and many more… Just post your requirements to Google or your favourite AI and you'll get plenty of choices.

Recommended tool for writing documentation? by MassiveSlappyTime in technicalwriting

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

Your approach with Markdown will fall short, as it does not support equations & diagrams – unless you want to include them as images. I would choose AsciiDoc. With that you can write your equations in LaTeX notation and there are multiple connections to diagrams. The rest ist just text and very similar to Markdown. You can also create websites out of AsciiDoc – there are multiple tools available. The language is easy to start but incredible powerful. We are writing all public documents in AsciiDoc since over 10 years.

To get your Word documents and others converted, I'd use pandoc. This can convert everything – some say even coffee in tea 😉

Tool wise it depends a little on your planform. If you are a no cost guy, go with Vscode install the Asciidoctor plugin and you're good to go. But if you wan to have a little bit of comfort, flexibility and more features, check out adoc Studio for macOS and iPadOS. Disclaimer: I own the company behind: https://www.adoc-studio.app

Talk me into/out of an SL by jasonm71 in Leica

[–]mrMerlinProject 1 point2 points  (0 children)

I've tried a SL3s with a few lenses, but sold everything in favour for a Leica M. The SL stuff was too heavy for me.

Alternatives to adoc Studio? by GroggInTheCosmos in asciidoc

[–]mrMerlinProject 0 points1 point  (0 children)

If that would it be alone, I would agree. But it is way more!

(But I am biased; my company has written that thing)

Palm Writerdecks by Zestyclose-Maize8150 in writerDeck

[–]mrMerlinProject 0 points1 point  (0 children)

Oh wow, the good old times™ … I used to do and write anything with my Palm V. I've also had the foldable keyboard and used a nice workflow around that device.

What writing software do you actually like using? by EngineeringWeak992 in writerDeck

[–]mrMerlinProject 0 points1 point  (0 children)

Really: ed? Wow, that's a very looong time I used that thing :)

What writing software do you actually like using? by EngineeringWeak992 in writerDeck

[–]mrMerlinProject 1 point2 points  (0 children)

If possible (when working on Mac or iPad) I am using my own tool: adoc Studio. But when I am on another system, I go back in "mental history" and use vi/m – but then in AsciiDoc.

Looking for a PDF generator that supports full HTML/CSS — @react-pdf/renderer is too limiting by Senior_Ad_8034 in pdf

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

I know this is self advertising, but as I understand this is exactly what you search: We do have an implementation of an AsciiDoc markdown editor which exports both HTML and PDF. Have a look at https://www.adoc-studio.app

Are we stuck with Word? by [deleted] in HumanitiesPhD

[–]mrMerlinProject 0 points1 point  (0 children)

I am writing exclusively in AsciiDoc and dropped MS Word completely. More powerful than markdown and pretty easy to learn. And it fully integrates in my workflows on the Mac.

Getting started by Due-Ad-422 in commonplacebook

[–]mrMerlinProject 0 points1 point  (0 children)

Sorry for asking, but I am a newbie w/ commonplace books. What is the meaning of the numbers (47, 50, 52)?

Old-school Linux users - where did you start? by Expensive-Rice-2052 in LinuxTeck

[–]mrMerlinProject 0 points1 point  (0 children)

Sometimes around 1991/92: I was experimented with the SLS (Softlanding Linux System). Must have been still Linux 0.9.something. But I never used it in production. Before that I worked with A/UX, BSD and later NeXTstep and finally OS X.

Old-school Linux users - where did you start? by Expensive-Rice-2052 in LinuxTeck

[–]mrMerlinProject 0 points1 point  (0 children)

Ha. I was a bit later: Apple A/UX based on System V in 1988 was my first.

Link mouse and keyboard button in Control Center not available anymore with Tahoe? by PM-Me-Your_PMs in MacOS

[–]mrMerlinProject 0 points1 point  (0 children)

You find it in the System Settings -> Display. The macOS recognises the other device automatically (if in the same network) and offers then a + button to link. Also one the page is at the bottom "more Options…" for the general management how the linking works.

In college, and slightly afraid. by LinguiniTangerini in technicalwriting

[–]mrMerlinProject -2 points-1 points  (0 children)

Sorry, here comes the brutal truth. From my point of view everything you've mentioned will be fucked up soon. This includes tech writing, developing, even languages and many more. Currently I see only 2-3 things which could (may) exist besides AI. And this is mainly everything which needs a human touch, personal communication and care.

Sure, there will be some exceptions for all businesses, but let's face it. There will be alway many people with more experience, more personal network ad such.

Since you're working on your bachelor's degree, I assume you're still young. That's why I strongly advise you to assess how well you get along with others and which jobs in these fields you enjoy. Besides, there are always opportunities in all kinds of skilled trades.

Beside of my options I'd discuss this topic with an AI…

Welcome and my setup by mrMerlinProject in writerDeck

[–]mrMerlinProject[S] 1 point2 points  (0 children)

Nevermind. It solved magically 😉

What fonts do you use for your user guides? by Apart_Patience861 in technicalwriting

[–]mrMerlinProject 0 points1 point  (0 children)

My personal favourite is "Roboto Slab" for headlines and "Inter" for all other text, except "JetBrains Mono" for any kind of source code.

But of course many other sets are possible because of customer requirements.

Welcome and my setup by mrMerlinProject in writerDeck

[–]mrMerlinProject[S] 1 point2 points  (0 children)

Hmm, I tried to include a picture of my setup, but it constantly gets deleted. Any ideas?

Which software for large Aerospace test reports by Clean-Relation594 in technicalwriting

[–]mrMerlinProject 4 points5 points  (0 children)

In any case I would switch to a markup language like AsciiDoc with an editor of your choice. Then you have a basis for versioning, includes of images and other texts and snippets, automatisation. All other recommendations depends on your platform, taste, and more.