MMS 2019 Docathon

During the Midwest Management Summit (MMS) 2019, the Microsoft content team for Configuration Manager and Microsoft Intune are running a docathon. If you're attending the Docs.microsoft.com hands-on lab session on Monday, 6 May, that time is to work on contributions with support from the Microsoft writers. The docathon runs the entirety of the conference, and any registered MMS 2019 attendee can participate.

Why should you participate? Docs.microsoft.com is an open-source platform for Microsoft product documentation, powered by GitHub. Microsoft encourages everyone to contribute to the docs! When you contribute, the platform recognizes you in the list of contributors on every article. The following contributions are some of the types that the community can provide:

  • Typos
  • Clarifications
  • Examples
  • Real-world guidance and tips
  • Content review, freshness

Set up

If you're not already set up to contribute, do these steps in advance.

GitHub account

Create a GitHub account

  • Identify any affiliations in your profile

  • Enable two-factor authentication

Additional considerations

  • Check your company's policy regarding open-source contributions

    Note

    Larger contributions will require that you accept the Microsoft open source Contributor License Agreement (CLA). Review this agreement in advance.

  • Contributions to docs.microsoft.com count toward MVP award consideration

  • Microsoft employees have a few more required one-time steps, and a slightly different contribution process

For more information, see GitHub account setup in the docs.microsoft.com Contributor Guide.

Scope

This event is only covering the following GitHub repositories:

You're also welcome and encouraged to make changes to other docs.microsoft.com content, but it won't credit towards this event.

Learn the process

Read info on how to file issues and how to contribute. Most basic changes can be done through the GitHub browser experience.

Note

If you're interested in the more complex workflow with git and VSCode, see Install content authoring tools. And/or ask Aaron/Erik for help. The following actions are some of the reasons why to use the more complex workflow:

  • Create a new article
  • Add images
  • String search and replace, including regular expressions
  • Larger, more complex changes

Determine your goal(s)

Start thinking about and planning your goal for this event. What do you want to accomplish?

  • Look through existing issues in the in-scope repositories. Labels such as good-first-issue or help-wanted can identify good starting points. If you want to tackle one of these issues, comment on it with #MMS2019Docathon and tag the @author, asking that they assign the issue to you. In other words, call dibs on it. Repeat this process as many times as you want.
    For example, in SCCMDocs, where Aaron is the article author: @aczechowski I'm claiming this issue for #MMS2019Docathon

  • You know of an issue with an article, but there's not yet any feedback filed. In other words, there's nothing in the Feedback section at the bottom of the article. File a new issue, then use the same instructions as above to claim it.

    • For example, add a code sample, a real-world example, or a common tip.

    • Avoid grammar or style changes, unless you talk with Aaron/Erik in advance.

    • Your favorite article has a date older than 90 days, before February 6, 2019. You can review it, and then your edit is to the ms.date metadata property. That contribution means: "I reviewed this article, and it's still technically accurate, so refresh the date." File an issue to claim it.

    • Check the article feedback first to make sure there isn't an open issue for someone that's already claimed it. This action isn't technically required. If you don't do it, and someone else submits first, we'll only take the first contribution.

  • The one hour lunch session on Monday is dedicated time to work towards these goals. Aaron & Erik are available to help with questions or problems.

Contest summary

The contest runs all week, 6 - 9 May. Any registered MMS 2019 attendee can participate. Submit entries by 3:00 PM Central on Thursday, May 9, 2019. Prizes will be awarded on Thursday, 9 May, after the ConfigMgr Product Team Q&A session. You need to be at MMS 2019 to win, but don't need to attend that session. If you're not at the session, to collect a prize, contact Aaron before he leaves Friday morning.

Important

You must include the #MMS2019Docathon hashtag in all contributions for credit.

Award categories

Grand prize

  • Most impactful: Based on the following criteria, judged by Aaron & Erik. If you think your submission should qualify, comment in your pull request to convince us why.

    • Benefit to community (50%)
    • Adherence to Microsoft Style (25%)
    • Proper markdown (25%)

The grand prize winner receives the following prizes:

  • A registration pass for MMS Jazz Edition, courtesy of the MMS steering committee, a $1799 value!
  • A branded Yeti Rambler 30 oz tumbler
  • A branded Popsocket car vent mount + grip

First place prizes

The following awards are calculated by the number of legitimate contributions to the in-scope repositories. They don't have to be merged or published, just submitted as a pull request by the end of the conference. We reserve the right to disqualify anyone who appears to be gaming the system. The winner in each category receives a branded Yeti Rambler 30 oz tumbler and branded Popsocket car vent mount + grip. One winner per category.

  • Most commits submitted

  • Most lines changed

  • Most articles touched

Note

We're not awarding a prize for the most issues filed. The feedback is helpful, but the point of this event is to contribute.

Resources

Official rules

Microsoft Cloud + AI Developer Relations Content & Learning MMS 2019 Docathon Event Contest OFFICIAL RULES

  1. SPONSOR

    These Official Rules ("Rules") govern the operation of the Microsoft C+AI DevRel Content MMS 2019 Docathon Event Contest ("Contest"). Microsoft Corporation is the sponsor ("Sponsor").

  2. DEFINITIONS

    In these Rules, "Microsoft", "we", "our", and "us", refer to Sponsor. "You" and "yourself" refers to a contest participant. "Event" refers to the MMS 2019 Docathon event held in Minneapolis, MN. By entering, you agree to be bound by these Rules.

  3. ENTRY PERIOD

    The Contest will operate during regular Event hours from May 6, 2019 to May 9, 2019 ("Entry Period").

  4. ELIGIBILITY

    Open to any registered Event attendee 18 years of age or older who is a legal resident of the 50 United States (including the District of Columbia). Employees and directors of Microsoft Corporation and its subsidiaries, persons involved in the execution or administration of this promotion, and the family members of each (dependents, immediate family members, and individuals living in the same household) aren't eligible. Void where prohibited.

    For business/tradeshow events: If you're attending the Event in your capacity as an employee, it is your sole responsibility to follow your employer's gift policies. Microsoft won't be party to any disputes or actions related to this matter. GOVERNMENT EMPLOYEES INCLUDING EDUCATORS: Microsoft is committed to following government gift and ethics rules and therefore government and public sector employees aren't eligible for this promotion.

  5. HOW TO ENTER

    To create an entry, submit edits to articles in the following GitHub repositories: IntuneDocs, SCCMDocs, sccm-docs-powershell-ref. For more information on the submission process, see How to contribute.

    To submit an entry, submit a pull request on GitHub.

    You can submit an unlimited number of entries. We'll only award one prize per category per person.

    We aren't responsible for excess, lost, late, damaged, or incomplete entries. If disputed, entries will be deemed submitted by the authorized account holder of the GitHub account.

  6. ELIGIBLE ENTRY

    To be eligible, an entry must meet the following content/technical requirements:

    • Your entry must be your own original work; and
    • Your entry musn't have been selected as a winner in any other contest; and
    • You must have obtained any and all consents, approvals, or licenses required for you to submit your entry; and
    • To the extent that entry requires the submission of user-generated contest such as software, photos, videos, music, artwork, essays, and so on, entrants warrant that their entry is their original work, hasn't been copied from others without permission or apparent rights, and doesn't violate the privacy, intellectual property rights, or other rights of any other person or entity. You may include Microsoft trademarks, logos, and designs, for which Microsoft grants you a limited license to use for the sole purposes of submitting an entry into this Contest; and
    • Your entry may NOT contain, as determined by us in our sole and absolute discretion, any content that is obscene or offensive, violent, defamatory, disparaging, or illegal, or that promotes alcohol, illegal drugs, tobacco, or a particular political agenda, or that communicates messages that may reflect negatively on the goodwill of Microsoft.
  7. USE OF ENTRIES

    We aren't claiming ownership rights to your Submission. However, by submitting an entry, you grant us an irrevocable, royalty-free, worldwide right and license to use, review, assess, test and otherwise analyze your entry and all its content in connection with this Contest and use your entry in any media whatsoever now known or later invented for any non-commercial or commercial purpose, including, but not limited to, the marketing, sale, or promotion of Microsoft products or services, without further permission from you. You won't receive any compensation or credit for use of your entry, other than what is described in these Official Rules.

    By entering, you acknowledge that we may have developed or commissioned materials similar or identical to your entry and you waive any claims resulting from any similarities to your entry. Further you understand that we won't restrict work assignments of representatives who have had access to your entry and you agree that use of information in our representatives' unaided memories in the development or deployment of our products or services don't create liability for us under this agreement or copyright or trade secret law.

    Your entry may be posted on a public website. We aren't responsible for any unauthorized use of your entry by visitors to this website. We aren't obligated to use your entry for any purpose, even if it has been selected as a winning entry.

  8. WINNER SELECTION AND NOTIFICATION

    Pending confirmation of eligibility, potential prize winners will be selected by Microsoft or their Agent or a qualified judging panel from among all eligible entries received based on the following judging criteria:

    • Grand prize: Most impactful, based on the following criteria:
      • 50% - Benefit to community
      • 25% - Adherence to Microsoft Style
      • 25% - Proper markdown
    • The following first place prizes, calculated by the number of legitimate contributions to the in-scope repositories. They don't have to be merged or published, just submitted as a pull request by the end of the conference. We reserve the right to disqualify anyone who appears to be gaming the system.
      • Most commits submitted
      • Most lines changed
      • Most articles touched

    Winners will be selected after 3:00 PM Central Time on Thursday, 9 May 2019.

    Winners will be notified at the Event, and must claim the prize before the close of the Event.

    If there's a tie between any eligible entries, an additional judge will break the tie based on the judging criteria described above. The decisions of the judges are final and binding. If we do not receive a sufficient number of entries meeting the entry requirements, we may, at our discretion, select fewer winners than the number of Contest Prizes described below.

    Winners will be notified via the contact information provided during entry and may be required to complete a prize claim and tax form ("Forms"). If a selected winner can't be contacted, is ineligible, fails to claim a prize, or fails to return any Forms, the selected winner will forfeit their prize, and an alternate winner will be selected time allowing. Only three alternate winners will be selected, after which unclaimed prizes will remain unawarded.

  9. PRIZES

    The following prizes will be awarded:

    • One (1) Grand Prize. A Prize Package consisting of the following items:

      • A registration pass for MMS Jazz Edition (provided by the MMS steering committee). Approximate Retail Value (ARV) $1799.
      • A Yeti Rambler 30 oz tumbler. Approximate Retail Value (ARV) $35.00.
      • A Popsocket car vent mount + grip. Approximate Retail Value (ARV) $15.00.

      The total Approximate Retail Value (ARV) of this Package is $1849.

    • Three (3) First Prize (s). A Prize Package consisting of the following items:

      • A Yeti Rambler 30 oz tumbler. Approximate Retail Value (ARV) $35.00.
      • A Popsocket car vent mount + grip. Approximate Retail Value (ARV) $15.00.

      The total Approximate Retail Value (ARV) of this Package is $50.

    The total Approximate Retail Value (ARV) of all prizes: $1999

    We will only award one (1) prize(s) per person. No more than the stated number of prizes will be awarded. No substitution, transfer, or assignment of prize permitted, except that Microsoft reserves the right to substitute a prize of equal or greater value in the event the offered prize is unavailable. Prizes are awarded "AS IS" with no warranty of any kind, either express or implied, including but not limited to, the implied warranties or merchantability, fitness for a particular purpose, or non-infringement. Prize winners may be required to complete and return prize claim and / or tax forms ("Forms") within the deadline stated in the winner notification. Taxes on the prize, if any, are the sole responsibility of the winner, who is advised to seek independent counsel regarding the tax implications of accepting a prize. By accepting a prize, you agree that Microsoft may use your entry, name, image, and hometown online and in print, or in any other media, in connection with this Contest without payment or compensation to you, except where prohibited by law.

  10. ODDS

    The odds of winning are based on the number and quality of eligible entries received.

  11. GENERAL CONDITIONS AND RELEASE OF LIABILITY

    To the extent allowed by law, by entering you agree to release and hold harmless Microsoft and its respective parents, partners, subsidiaries, affiliates, employees, and agents from any and all liability or any injury, loss, or damage of any kind arising in connection with this Contest or any prize won.

    All local laws apply. The decisions of Microsoft are final and binding.

    We reserve the right to cancel, change, or suspend this Contest for any reason, including cheating, technology failure, catastrophe, war or any other unforeseen or unexpected event that affects the integrity of this Contest, whether human or mechanical. If the integrity of the Contest can't be restored, we may select winners from among all eligible entries received before we had to cancel, change, or suspend the Contest. Rules violators will be prosecuted to the full extent of the law and may be banned from participation in Microsoft Contests.

  12. WINNERS LIST

    The list of prize winners will be posted to https://aka.ms/mms2019docathon within 30 days of May 9, 2019.

  13. PRIVACY

    At Microsoft, we are committed to protecting your privacy. Microsoft uses the information you provide on this form to notify you of important information about our products, upgrades and enhancements, and to send you information about other Microsoft products and services. Microsoft won't share the information you provide with third parties without your permission except where necessary to complete the services or transactions you have requested, or as required by law. Microsoft is committed to protecting the security of your personal information. We use a variety of security technologies and procedures to help protect your personal information from unauthorized access, use, or disclosure. Your personal information is never shared outside the company without your permission, except under conditions explained above.

    If you believe that Microsoft has not adhered to this statement, please contact Microsoft by sending an email to privrc@microsoft.com or postal mail to Microsoft Privacy Response Center, Microsoft Corporation, One Microsoft Way, Redmond, WA 98052.