Re: Microsoft Manual of Style vs. github.com/MicrosoftDocs/microsoft-style-guide

Subject: Re: Microsoft Manual of Style vs. github.com/MicrosoftDocs/microsoft-style-guide
From: Tony Chung <tonyc -at- tonychung -dot- ca>
To: TECHWR-L <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Thu, 16 Aug 2018 11:46:26 -0700

What they say and what Github enables are totally different things. If MS
is not open to external pull requests against their documentation, there's
nothing stopping us from forking the MSWSG to, say the TechWhirlers Style
Guide and rewriting everything to fit our image. But then that begs the
question, why start with something so MS-centric? Apple has its own Human
Interface Style Guide that describes things almost exactly the opposite of
MS. And as Robert mentioned, and that I am inclined to agree, why Markdown?

-T

On Thu, Aug 16, 2018 at 11:34 AM, Lauren <lauren -at- writeco -dot- net> wrote:

> They say they have always used GitHub but now they are using it for
> feedback and issues. You can't just go in to GitHub and write or edit for
> Microsoft. Whether comments are posted on Git or sent through email, all
> the public can do is comment. They are trying to attract millennials.
>
> https://docs.microsoft.com/en-us/teamblog/a-new-feedback-sys
> tem-is-coming-to-docs
>
>
> On 8/16/2018 11:12 AM, Tony Chung wrote:
>
>> I think what we need to take away is that this manual is a public project
>> on github, which opens up all opportunities for branching, pull requests,
>> and even forking of the same documentation project. I don't know if MS
>> intended for such decentralization, but that's what they've opened
>> themselves up to. They might have purchased github as a way to centralize
>> their source, but git as a source control lends itself to
>> decentralization.
>>
>> The fact MicrosoftDocs is the project owner of multiple repositories shows
>> that there is some attempt for developers to add documentation at the same
>> time as they are building features. And they are probably looking for
>> git-savvy tech writers to submit pull requests to improve their docs. If I
>> were a techcom student, between contracts, or passionate about some of the
>> technology I might check with the project owners if they would accept pull
>> requests from the outside.
>>
>> To date, the most successful attempt at documentation-by-community that
>> I've heard about is FlossManuals: http://en.flossmanuals.net/
>>
>> Seeing that the Microsoft Writing Style Guide is in need of editorial
>> support, if you've got the interest and/or time, it couldn't hurt to take
>> up git.
>>
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> Visit TechWhirl for the latest on content technology, content strategy and
> content development | http://techwhirl.com
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> You are currently subscribed to TECHWR-L as tonyc -at- tonychung -dot- ca -dot-
>
> To unsubscribe send a blank email to
> techwr-l-leave -at- lists -dot- techwr-l -dot- com
>
>
> Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
> http://www.techwhirl.com/email-discussion-groups/ for more resources and
> info.
>
> Looking for articles on Technical Communications? Head over to our online
> magazine at http://techwhirl.com
>
> Looking for the archived Techwr-l email discussions? Search our public
> email archives @ http://techwr-l.com/archives
>
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Visit TechWhirl for the latest on content technology, content strategy and content development | http://techwhirl.com

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-leave -at- lists -dot- techwr-l -dot- com


Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwhirl.com/email-discussion-groups/ for more resources and info.

Looking for articles on Technical Communications? Head over to our online magazine at http://techwhirl.com

Looking for the archived Techwr-l email discussions? Search our public email archives @ http://techwr-l.com/archives


Follow-Ups:

References:
Microsoft Manual of Style vs. github.com/MicrosoftDocs/microsoft-style-guide: From: Robert Lauriston
Re: Microsoft Manual of Style vs. github.com/MicrosoftDocs/microsoft-style-guide: From: Lauren
Re: Microsoft Manual of Style vs. github.com/MicrosoftDocs/microsoft-style-guide: From: Lauren

Previous by Author: Re: 2. What's your preference: One long page or several small pages?
Next by Author: Re: Gmail [Reply] routing help
Previous by Thread: Re: Microsoft Manual of Style vs. github.com/MicrosoftDocs/microsoft-style-guide
Next by Thread: Re: Microsoft Manual of Style vs. github.com/MicrosoftDocs/microsoft-style-guide


What this post helpful? Share it with friends and colleagues:

Sponsored Ads


Sponsored Ads