MSDN Skype Web SDK Documentation now on GitHub!
The contents of the Skype Web SDK documentation (up until now published on MSDN) are also now on GitHub, at https://github.com/OfficeDev/skype-docs.
Right now, it’s just Skype Web SDK documentation that’s included, but it looks like space is being left open for documentation for other Skype developer technologies to be added over time.
“Contribute in GitHub” links have started showing up in MSDN as well:
This is a big deal for a couple of reasons:
- it makes it much easier for corrections, clarifications and contributions to come from outside of Microsoft, via pull requests.
- it should hopefully be easier to find stuff, and really useful pages of documentation can be kept offline and referred to without requiring an internet connection, for instance when travelling.
- it’s presented in a format every developer is comfortable with – source code repro style!
- overall, it should mean that the quality and relevence of the documentation improves over time, which is awesome!
As of right this second, there is a note in the README.md stating that only pull requests from within Microsoft can be accepted. However, I think (though I don’t know) that this is just whilst the kinks in the license approval process take place, and things will work themselves out eventually.
The content is part of a larger collection of documentation collated at the top-level https://github.com/OfficeDev repository. This is a great source of content from across the Office platform, containing loads and loads of different repositories. It’s pretty exciting! 🙂
You Can Contribute (or will be able to soon!)
The great thing about documentation being in GitHub is that you can contribute: either by submitting minor corrections to code examples, spelling errors etc, or larger contributions such as new articles and code samples. Some contributions require you to sign a Contribution License Agreement: for more details see:Â https://github.com/OfficeDev/skype-docs/blob/master/README.md.
This is really exciting, and I think represents a real opening up of relations between developers and the Skype for Business Product Team. Now, if there’s a problem with the documentation or something isn’t clear there’s somewhere you can go to get it resolved, and help make the world a little bit easier for the next developer!
0 Comments
Trackbacks/Pingbacks