Re:Nerds don't respond to marketing; try technical documenta...
by marcosdumay on Monday August 16, 2021 @10:47AM
(#28198758)
> details are so technical that they're hard to explain without "just look at the code type explanations".
> Sometimes the documentation writer can't provide a "plain English" overview of the technology.
So lead your marketing material with the code and explanations or tutorials, or whatever. (But I'm repeating the article now...)
> the details are the proprietary IP / secret sauce of the company
This one isn't reasonable. It's the detail of how to use and how it can be used that are important, not how it works. If you can't tell those, how do people use your product? Do you make your customers sign an NDA before they buy it? (Yeah, some products do require an NDA before you buy them, you can expect those ones to be very hard to sell.)
> Sometimes the documentation writer can't provide a "plain English" overview of the technology.
So lead your marketing material with the code and explanations or tutorials, or whatever. (But I'm repeating the article now...)
> the details are the proprietary IP / secret sauce of the company
This one isn't reasonable. It's the detail of how to use and how it can be used that are important, not how it works. If you can't tell those, how do people use your product? Do you make your customers sign an NDA before they buy it? (Yeah, some products do require an NDA before you buy them, you can expect those ones to be very hard to sell.)