Microsoft maintains a suite of sample IoT projects on GitHub at

Primarily it is a site for appropriate Microsoft staff to maintain the site by

  1. Contributing projects
  2. Extending existing projects
  3. Providing code corrections (bug fixes)
  4. Providing code improvements,

The question is, do they want community contributions? The site was originally worded in its ReadMe it appeared to seek community contributions in all four areas. During a recent discussion I had with the repository principals, it was decided that going forward in the long term, for maintainability, community contributions would only be sought in 3., bug fixes.

To that end, I have created a GitHub repository where developers can deposit a ReadMe.MD (ReadMe replaced by the project name). The file will have a simple textual database record at the top listing project properties, including a relative link to the project’s GitHub repository. The website as discussed here, is then able to get the deposited project ,md files and extract the database records, It then can import them to the site’s database (actually a json file) and save the .md file (without the db record) for display via the web site. The web site is able to list the records (key properties only) which can be filtered/searched and sorted based upon these project properties. Users are then able to select a project and view the complete db record. From there they are able to view the complete project ,md file.

This sequence of blogs briefly discusses the techniques/technologies used for the web site which include:

  • Nancy
  • Razor
  • GitHub API



  1. The Web Site (Now online):  Take the Community Site link on right.
  2. The MD Repository on GitHub
  3. The Web Site Project Code Repository 


Contributions are now sought for 2, as Markdown format (.md) project descriptions. See1.