Skip to content

Commit

Permalink
Initial Website Build
Browse files Browse the repository at this point in the history
  • Loading branch information
ChrisKibble committed Jul 12, 2021
1 parent b240c72 commit ffb1b4f
Show file tree
Hide file tree
Showing 168 changed files with 1,453 additions and 0 deletions.
6 changes: 6 additions & 0 deletions archetypes/default.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
---
title: "{{ replace .Name "-" " " | title }}"
date: {{ .Date }}
draft: true
---

4 changes: 4 additions & 0 deletions config.toml
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
baseURL = "https://datafornerds.io/"
languageCode = "en-us"
title = "DataForNerds"
theme = "hugo-geekdoc-0.14.1"
55 changes: 55 additions & 0 deletions content/Data Sources/ms-msapps-buildnumbers.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,55 @@
---
title: "Microsoft M365 Apps Builds"
date: 2021-07-08T16:28:20-04:00
draft: false
---

Microsoft M365 Apps for Business (formerly Office 365) build numbers are in JSON format at this address: [https://raw.datafornerds.io/ms/msapps/buildnumbers.json](https://raw.datafornerds.io/ms/msapps/buildnumbers.json). The source of this information is [this site](https://docs.microsoft.com/en-us/officeupdates/update-history-microsoft365-apps-by-date). The data is validated hourly.

## Known Issues
The following known issues are pending correction:
- [Some Office Versions have a space in the version number](https://github.com/DataForNerds/public/issues/10)
- [Office Builds Without Years are Defaulting to 2021](https://github.com/DataForNerds/public/issues/11)

## Sample Data
```json
{
"DataForNerds": {
"LastUpdatedUTC": "\/Date(1625771575455)\/",
"SourceList": ["https://docs.microsoft.com/en-us/officeupdates/update-history-microsoft365-apps-by-date"]
},
"Data": [{
"ReleaseDate": "2017-12-12",
"Channel": "Semi-Annual Enterprise",
"Build": "7766.2130",
"Version": "1701",
"FullBuild": "16.0.7766.2130"
}, {
"ReleaseDate": "2018-08-14",
"Channel": "Semi-Annual Enterprise",
"Build": " 8431.2299",
"Version": "1708",
"FullBuild": "16.0. 8431.2299"
}, {
"ReleaseDate": "2021-12-06",
"Channel": "Current",
"Build": "8730.2122",
"Version": "1711",
"FullBuild": "16.0.8730.2122"
}]
}
```

## Sample Usage in PowerShell

```powershell
$d4n = Invoke-RestMethod -Uri "https://raw.datafornerds.io/ms/msapps/buildnumbers.json"
Write-Host "Builds Released in Past 7 days"
ForEach($build in $d4n.Data) {
$diff = New-TimeSpan -Start (Get-Date $build.ReleaseDate) -End (Get-Date)
If($diff.TotalDays -le 7) {
Write-Host "Office 365 Version $($build.FullBuild) is $($build.Version) and was released $($build.ReleaseDate)"
} else { <# Do Nothing #> }
}
```
74 changes: 74 additions & 0 deletions content/Data Sources/ms-mswin-buildnumbers.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,74 @@
---
title: "Microsoft Windows Builds"
date: 2021-07-08T16:28:20-04:00
draft: false
---

Windows Builds are available in JSON format at this address: [https://raw.datafornerds.io/ms/mswin/buildnumbers.json](https://raw.datafornerds.io/ms/mswin/buildnumbers.json). The source of this information is [this site](https://docs.microsoft.com/en-us/windows/release-health/release-information). The data is validated hourly.


## Sample Data
```json
{
"DataForNerds": {
"LastUpdatedUTC": "\/Date(1625758980460)\/",
"SourceList": [
"https://docs.microsoft.com/en-us/windows/release-health/release-information",
"https://winreleaseinfoprod.blob.core.windows.net/winreleaseinfoprod/en-US.html"
]
},
"Data": [{
"Win10Version": "10.0.10240.16683",
"Version": "10240.16683",
"ReleaseDate": "2016-02-09",
"Article": "KB3135174",
"Comment": ""
}, {
"Win10Version": "10.0.19042.1055",
"Version": "19042.1055",
"ReleaseDate": "2021-06-11",
"Article": "KB5004476",
"Comment": "Out-of-band"
}, {
"Win10Version": "10.0.19043.1055",
"Version": "19043.1055",
"ReleaseDate": "2021-06-11",
"Article": "KB5004476",
"Comment": "Out-of-band"
}, {
"Win10Version": "10.0.17763.2028",
"Version": "17763.2028",
"ReleaseDate": "2021-06-15",
"Article": "KB5003703",
"Comment": "Preview"
}, {
"Win10Version": "10.0.10240.16769",
"Version": "10240.16769",
"ReleaseDate": "2016-04-12",
"Article": "KB3147461",
"Comment": ""
}]
}
```

## Sample Usage in PowerShell

```powershell
$d4n = Invoke-RestMethod -Uri "https://raw.datafornerds.io/ms/mswin/buildnumbers.json"
$props = Get-ItemProperty 'HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion'
$osVer = ([string]$props.CurrentMajorVersionNumber + '.' + [string]$props.CurrentMinorVersionNumber + '.' + [string]$props.CurrentBuildNumber + '.' + [string]$props.UBR)
$myBuild = $d4n.data | Where-Object { $_.Win10Version -eq $osVer }
Write-Host "You are running $osVer with Update $($myBuild.Article)"
Write-Host "Your patch level was released by Microsoft on $($myBuild.ReleaseDate)"
$patchDiff = New-TimeSpan -Start (Get-Date $myBuild.ReleaseDate) -End (Get-Date)
If($patchDiff.TotalDays -ge 30) {
Write-Host "It might be time to look for an updated patch!" -ForegroundColor Red
} else {
Write-Host "You're patch is recent enough." -ForegroundColor Green
}
```
50 changes: 50 additions & 0 deletions content/Data Sources/ms-mswin-releases.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,50 @@
---
title: "Microsoft Windows Releases"
date: 2021-07-08T16:28:20-04:00
draft: false
---

Windows Release IDs are available in JSON format at this address: [https://raw.datafornerds.io/ms/mswin/buildnumbers.json](https://raw.datafornerds.io/ms/mswin/releases.json). The source of this information is [this site](https://docs.microsoft.com/en-us/windows/release-health/release-information) which contains a link to [this data](https://winreleaseinfoprod.blob.core.windows.net/winreleaseinfoprod/en-US.html). The data is validated hourly.

## Sample Data
```json
{
"DataForNerds": {
"LastUpdatedUTC": "2021-07-08T15:56:35.0659636Z",
"SourceList": [
"https://docs.microsoft.com/en-us/windows/release-health/release-information",
"https://winreleaseinfoprod.blob.core.windows.net/winreleaseinfoprod/en-US.html"
]
},
"Data": [{
"Version": "10240",
"FullVersion": "10.0.10240",
"Build": "1507 (RTM)"
}, {
"Version": "10586",
"FullVersion": "10.0.10586",
"Build": "1511"
}, {
"Version": "19042",
"FullVersion": "10.0.19042",
"Build": "20H2"
}, {
"Version": "19043",
"FullVersion": "10.0.19043",
"Build": "21H1"
}]
}
```

## Sample Usage in PowerShell

```powershell
$d4n = Invoke-RestMethod -Uri "https://raw.datafornerds.io/ms/mswin/releases.json"
$myW10Version = Get-CimInstance Win32_OperatingSystem | Select -ExpandProperty BuildNumber
$myBuild = $d4n.data | Where-Object { $_.Version -eq $myW10Version }
Write-Host "I am running Windows 10 Build Number $($myW10Version) which is $($myBuild.Build)."
```
14 changes: 14 additions & 0 deletions content/Using the Data/powerbi.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
---
title: "Microsoft PowerBI"
date: 2021-07-08T16:28:20-04:00
draft: false
---

The data from DataForNerds can be brought into PowerBI using the Web data source type. The following steps outline the overall steps to gather the data.

1. Launch PowerBI Desktop. Create a new report or open an existing report.
2. From the `Home` ribbon, select `Get Data`. Either select `Web` from the drop down (if available), or select `More` and then choose `Web` from the resulting dialog box.
3. Enter the URL to the JSON file (e.g. [https://raw.datafornerds.io/ms/mswin/releases.json](https://raw.datafornerds.io/ms/mswin/releases.json)) and click OK.
4. You may be prompted for authentication parameters (you can use anonymous authentication) or be prompted to apply your new changes to the report.

The data is now available as a source within your PowerBI report that can be linked to existing data and displayed.
27 changes: 27 additions & 0 deletions content/Using the Data/powershell.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
---
title: "Microsoft PowerShell"
date: 2021-07-08T16:28:20-04:00
draft: false
---

The data from DataForNerds can be brought into PowerShell as a Custom Object using the `Invoke-RestMethod` command and passing it the JSON URL as the `uri` parameter. For example:

```powershell
$d4n = Invoke-RestMethod -Uri "https://raw.datafornerds.io/ms/mswin/releases.json"
```

The resulting object typically have two properties:

Property|Purpose
-|-
DataForNerds|Metadata containing at least the information about the last time the content was updated (LastUpdatedUTC property) and where we got the information from (SourceList property).
Data|The actual data you're looking for.

To view the data in PowerShell, output the data property. For example:

```powershell
$d4n = Invoke-RestMethod -Uri "https://raw.datafornerds.io/ms/mswin/releases.json"
$d4n.Data | Format-Table -AutoSize
```

You can use the Data property like any other array of objects in PowerShell. It can be viewed, sorted, queried, exported, etc.
12 changes: 12 additions & 0 deletions content/_index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
---
title: "Data for Nerds"
date: 2021-07-08T16:12:33-04:00
draft: false
---

## Hello World, what am I doing here?
Isn't it crazy that, as IT professionals, we're constantly looking to peice together information from all over the web into a useable format for querying, coding, and reporting? And it's never in a format that's _actually_ useful so we either build our own database tables (that we never keep up to date), we depend on normalization products, or we come up with kluge solutions that are never maintainable long term. That's the problem we're trying to solve here. We want to collect the data once, put it into an easily consumed format (JSON), and then let anyone and everyone come use it.

## So, how do I get started?

To kick things off, we have a few pretty commonly used
1 change: 1 addition & 0 deletions themes/hugo-geekdoc-0.14.1/.vnuignore
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
.*border-content.*
20 changes: 20 additions & 0 deletions themes/hugo-geekdoc-0.14.1/LICENSE
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
The MIT License (MIT)

Copyright (c) 2021 Robert Kaussow

Permission is hereby granted, free of charge, to any person obtaining a copy of
this software and associated documentation files (the "Software"), to deal in
the Software without restriction, including without limitation the rights to
use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
the Software, and to permit persons to whom the Software is furnished to do so,
subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
44 changes: 44 additions & 0 deletions themes/hugo-geekdoc-0.14.1/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,44 @@
# Geekdoc

[![Build Status](https://img.shields.io/drone/build/thegeeklab/hugo-geekdoc?logo=drone&server=https%3A%2F%2Fdrone.thegeeklab.de)](https://drone.thegeeklab.de/thegeeklab/hugo-geekdoc)
[![Hugo Version](https://img.shields.io/badge/hugo-0.83-blue.svg)](https://gohugo.io)
[![GitHub release](https://img.shields.io/github/v/release/thegeeklab/hugo-geekdoc)](https://github.com/thegeeklab/hugo-geekdoc/releases/latest)
[![GitHub contributors](https://img.shields.io/github/contributors/thegeeklab/hugo-geekdoc)](https://github.com/thegeeklab/hugo-geekdoc/graphs/contributors)
[![License: MIT](https://img.shields.io/github/license/thegeeklab/hugo-geekdoc)](https://github.com/thegeeklab/hugo-geekdoc/blob/main/LICENSE)

Geekdoc is a simple Hugo theme for documentations. It is intentionally designed as a fast and lean theme and may not fit the requirements of complex projects. If a more feature-complete theme is required there are a lot of got alternatives out there. You can find a demo and the full documentation at [https://geekdocs.de](https://geekdocs.de).

![Desktop and mobile preview](https://raw.githubusercontent.com/thegeeklab/hugo-geekdoc/main/images/readme.png)

## Build and release process

This theme is subject to a CI driven build and release process common for software development. During the release build, all necessary assets are automatically built by [gulp](https://gulpjs.com/) and bundled in a release tarball. You can download the latest release from the GitHub [release page](https://github.com/thegeeklab/hugo-geekdoc/releases).

Due to the fact that `gulp` is used as pre-processor the theme cannot be used from the main branch by default. If you want to use the theme from a cloned branch instead of a release tarball you'll need to install `gulp` locally and run the default pipeline once to create all required assets.

```Shell
# install required packages from package.json
npm install

# run gulp pipeline to build required assets
npx gulp default
```

See the [Getting Started Guide](https://geekdocs.de/usage/getting-started/) for details about the different setup options.

## Contributors

Special thanks goes to all [contributors](https://github.com/thegeeklab/hugo-geekdoc/graphs/contributors). If you would like to contribute,
please see the [instructions](https://github.com/thegeeklab/hugo-geekdoc/blob/main/CONTRIBUTING.md).

Geekdoc is inspired and partially based on the [hugo-book](https://github.com/alex-shpak/hugo-book) theme, thanks [Alex Shpak](https://github.com/alex-shpak/) for your work.

## License

This project is licensed under the MIT License - see the [LICENSE](https://github.com/thegeeklab/hugo-geekdoc/blob/main/LICENSE) file for details.

The used SVG icons and generated icon fonts are licensed under the license of the respective icon pack:

- Font Awesome: [CC BY 4.0 License](https://github.com/FortAwesome/Font-Awesome#license)
- IcoMoon Free Pack: [GPL/CC BY 4.0](https://icomoon.io/#icons-icomoon)
- Material Icons: [Apache License 2.0](https://github.com/google/material-design-icons/blob/main/LICENSE)
1 change: 1 addition & 0 deletions themes/hugo-geekdoc-0.14.1/VERSION
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
v0.14.1
7 changes: 7 additions & 0 deletions themes/hugo-geekdoc-0.14.1/archetypes/docs.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
title: "{{ .Name | humanize | title }}"
weight: 1
# geekdocFlatSection: false
# geekdocToc: 6
# geekdocHidden: false
---
4 changes: 4 additions & 0 deletions themes/hugo-geekdoc-0.14.1/archetypes/posts.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
---
title: "{{ replace .Name "-" " " | title }}"
date: {{ .Date }}
---
Loading

0 comments on commit ffb1b4f

Please sign in to comment.