Comment by gelberhut@lemdro.id on Obsidian for Writing Manuals

Is Obsidian a good tool to use for writing technical manuals? I would like to write an Operation Manual for municipality’s water system. There will be embedded screenshots and some links to other sections of the document.

Ideally we could “publish” to offline html. The customer would also like a printed manual.

If Obsidian is no good, I would love suggestions on software you have used to write short manuals with pictures, preferably not Word.

Do not forget to purchase proper obsidian license - your usecase is not covered by a free version.

Can you elaborate on this? Are you referencing their “Publish” feature?

@gelberhut @effingjoe if I am a freelancer who gets paid for work done using #obsidian this doesn’t apply. Correct me if I’m wrong.

@tamowafy @gelberhut @effingjoe AFAIK you need to be working in a for-profit organization with 2 or more employees to need a commercial license for #Obsidian.

Hm. I keep notes in Obsidian, including work notes. I wonder if that violates the license. I might abandon Obsidian over this.

Eh. Theoretically, maybe. Practically, this is a problem of ‘what constitutes work use’.

In my opinion, the work notes I take in obsidian are my personal notes. I found obsidian myself, and use it myself for taking notes for work. Stuff doesn’t get shared to coworkers, other than the actual text I am writing when I copy paste it out of obsidian.

OP’s use case is a work use, in my opinion, as they are using obsidian to produce the output used for work.

Same would apply if a team used obsidian for notes, encouraged use of it for everyone in the team, and/or uses shared vaults as a ‘wiki’.

‘what constitutes work use

It’s Commercial Use as opposed to Private Use.

“Commercial use describes any activity in which you use a product or service for financial gain. This includes whenever you use software to create marketing materials, since those materials are used for business purposes with the intention of increasing sales.” - HubSpot

In other words: You use it as a means to make money. Plain and simple.

It’s bad news for Obsidian, not me. There’s a million note taking applications out there.

It’s bad news for Obsidian, not me.

How is that bad news for Obsidian? The creators don’t care that you don’t use their product if you are not willing to pay for it. What a strange way to frame it like Obsidian Dev Team would need to woo you to use their product by giving it to you for free or something like that. Bizarre.

There’s a million note taking applications out there.

Those have commercial licensing requirements as well. The issue is not Obsidian, but your intent on commercial use. Obsidian actually has very generous terms btw: free for education, private use and freelance. Compare that to the license requirement of any other common software you use.

I might abandon Obsidian over this.

You could just get rid of your MS Office License instead, but this seems more like a common value issue, where users don’t value the work invested in developing a tool/thing as highly as the creator.

Also: Other note-taking apps have other licensing requirements or in-app-ads. Assuming you could dodge paying for one service by migrating your operations to another one is naive.

Unofficial Lemmy community for https://obsidian.md

Obsidian for Writing Manuals

ObsidianMD

!obsidianmd@lemmy.world

Community stats

Community moderators