TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
There are few doc design errors worse than collapsed text that doesn't
turn up in an in-page search.
Clicking a link to continue reading is standard in lots of contexts.
Offering several such links if there's more than one possible
successor seems absolutely standard to me. Conceptual topics such as
the one in the example often are logical prefaces to many procedural
topics.
"... does every paragraph really need to have it's own comments
thread?" It doesn't. The comments are in the page footer.
I see they're using Livefyre for that. Anybody have experience with it?
On Mon, May 9, 2016 at 12:12 PM, Andrew Harvie <withanie -at- gmail -dot- com> wrote:
> They seem to be doing several things well, but mostly it's about making the
> documentation page easy to read.
>https://docs.microsoft.com/teamblog/introducing-docs-microsoft-com/
>
> I mostly like the idea of having the url match the header.
> I find it interesting that they plan to break up longer articles into
> smaller ones. I thought the in-thing was scrolling over clicking.
> Going back to the sample site where Intune is documented, I'm not at all
> keen on the "In this article" links that boot you to a section at the
> bottom of the page. I know that there are folks here who dislike expanding
> sections, but isn't this worse?
> And, does every paragraph really need to have it's own comments thread?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Visit TechWhirl for the latest on content technology, content strategy and content development | http://techwhirl.com
