Lief Erickson
Lief Erickson
## Expected Behavior Curly quotes (and possibly other characters) are supported in files referenced by `coderef` and no topic-fragment errors are present in the log. ## Actual Behavior When building...
One [dictionary definition](https://www.google.com/search?num=10&ei=b2duW9OYJIXSjwSahYn4Cg&q=flat+file+definition) of _flat file_ is a file that does not have internal hierarchy. I don't think that's the what is meant here. Is _text-based file_ what's intended? I...
I agree that code-like writing is very powerful. No disagreement. "Only languages and toolchains that offer you inline dynamism — and here I mean DITA as much as AsciiDoc or...
Dynamic content is extremely powerful. In this section about dynamic writing do you want to keep the section generic about the fact that you can use variables (or whatever they...
_Figure 3. Semantic structure in Oxygen XML Editor (Source: oxygenxml.com (c) SyncRO Soft SR, republished under Fair Use)_ While true that is what the oXygenXML interface _can_ look like I...
There is a lot of research supporting the statement that people skim [your content]. https://uxmyths.com/post/647473628/myth-people-read-on-the-web https://www.nngroup.com/articles/how-users-read-on-the-web/ Anyone with hotjar (or similar) installed on their site will see this as well....
> 3. All content can be single-sourced, meaning tech writers and engineers maintain one canonical source of truth, no matter how many places that content needs to appear in the...
> *First, all technical writing should be sourced in markup and compiled to rich output* like HTML and PDF, or specialized output such as Unix "man" pages, user interface elements,...
> Well kept, these are also your assets -- they include all the answers SMEs have forgotten or misremembered. Not just _your_ assets, but the _company's_ assets, and the company...
> Docs may not close deals very often, but bad docs can frustrate, costing degrees of a potential customer's confidence. TODO: find the statistics that say that 60-78% of all...