Hacker News Reader

Comment by digitalPhonix | Hacker News Reader

I think Publisher would be the equivalent to FrameMaker from the Office suite. Publisher from Office ~2016 could definitely do that.

Unfortunately I think Publisher has faired even worse than Word in terms of stagnation, and now looks to be discontinued?

View on HN

Publisher is the equivalent of InDesign. It was meant for brochures and so on. If you want to write a long technical manual today most people use Word. In that respect we are using less powerful software today than our grandparents.

Note: Adobe bought FrameMaker and continues to sell FrameMaker. But Word has captured the market not because of its technical merit but because of bundling.

I have never written any technical manuals, but I'm surprised that Word is the choice of tool. How does one embed e.g. code easily in the document? I feel there must be a better way to do it, maybe some kind of markdown syntax? Latex?

> How does one embed e.g. code easily in the document?

You don't. For APIs and such, documentation is published online, and you don't need Word for that. Word is used in some industries, where printed manual is needed.

What about the printed manuals? I think they still have some of those not too long ago (e.g. Intel manuals). What was the tool chosen? Very curious to know.

Or, maybe a legacy example -- how were the printed manuals of Microsoft C 6.0 written? That was in the early 90s I think.

Framemaker.

Thanks, thought MSFT was using its own tools.

If you don't make it, you can't use it.

Microsoft has never made a technical publishing package, so it has to be outsourced.

Yeah I agreed. Kinda missed the old days with thick manuals. I bought one for gdb a couple of years ago and love it -- despite it is just the paper version of the online one.

Correct, it is going away as of October this year.

Reply on news.ycombinator.com