Deneas Deneas

.NET OSS Documentation tools

Criteria

What dependencies does it require? (npm, netfx, dotnet-core)
Does it seem to be maintained?
Does it have a good update story?
How easy is it to get started? (good tutorial, templating)
Can I change the structure easily to fit the divio structure?
Does it support search? Is the search useful?

GitHub Repository Checklist (C#)

Have a repository on GitHub? Planning on making a repository on GitHub? This checklist is intended to introduce you to various features that may help you make the most of your GitHub repository with specific recommendations for C# repositories.

Checklist

These are only suggestions.
They may not be appropriate for all repositories.
They are in no particular order.
Click each item to expand for more information.

Download courses from learning sites with `youtube-dl`

You can download whole courses from an array of tutorial sites with the CLI tool youtube-dl. In the example further down I'm using my Pluralsight account to get videos from a course at their site. Here is a list of all supported sites that you can download from with this tool

The flags you have to supply may vary depending on which site you make a request to.

You can get a free 3 month trial to Pluralsight by signing up for free to Visual Studio Dev Essentials

Installation

GPU Optimization for GameDev

Graphics Pipeline / GPU Architecture Overview

2011 - A trip through the Graphics Pipeline 2011
2013 - Performance Optimization Guidelines and the GPU Architecture behind them
2015 - Life of a triangle - NVIDIA's logical pipeline
2015 - Render Hell 2.0
2016 - How bad are small triangles on GPU and why?
2017 - GPU Performance for Game Artists
2019 - Understanding the anatomy of GPUs using Pokémon

Converting mkv to mp4 with `ffmpeg`

Essentially just copy the existing video and audio stream as is into a new container, no funny business!

The easiest way to "convert" MKV to MP4, is to copy the existing video and audio streams and place them into a new container. This avoids any encoding task and hence no quality will be lost, it is also a fairly quick process and requires very little CPU power. The main factor is disk read/write speed.

With ffmpeg this can be achieved with -c copy. Older examples may use -vcodec copy -acodec copy which does the same thing.

These examples assume ffmpeg is in your PATH. If not just substitute with the full path to your ffmpeg binary.

	/*
	Erosion noise implementation in C# (with the Unity.Mathematics package),
	ported one-to-one from the Shadertoy shader code by Fewes and clayjohn.

	Please note that while the majority of the code is provided under the MIT license,
	the quite central "erosion" function is adapted from code shared under the
	Creative Commons Attribution-NonCommercial-ShareAlike 3.0 Unported License.

	Shadertoy comment by Fewes from https://www.shadertoy.com/view/7ljcRW :

	using System.Collections.Immutable;
	using Microsoft.CodeAnalysis;
	using Microsoft.CodeAnalysis.CSharp.Syntax;
	using Microsoft.CodeAnalysis.Diagnostics;
	using DiagnosticDescriptor = Microsoft.CodeAnalysis.DiagnosticDescriptor;
	using DiagnosticSeverity = Microsoft.CodeAnalysis.DiagnosticSeverity;
	using LanguageNames = Microsoft.CodeAnalysis.LanguageNames;
	using SyntaxKind = Microsoft.CodeAnalysis.CSharp.SyntaxKind;

	namespace Gist;

	/*
	MIT License

	Copyright (c) [year] [fullname]

	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

	# Loads a scene in the background using a seperate thread and a queue.
	# Foreach new scene there will be an instance of ResourceInteractiveLoader
	# that will raise an on_scene_loaded event once the scene has been loaded.
	# Hooking the on_progress event will give you the current progress of any
	# scene that is being processed in realtime. The loader also uses caching
	# to avoid duplicate loading of scenes and it will prevent loading the
	# same scene multiple times concurrently.
	#
	# Sample usage:
	#

	# This should be included in SQL server if you have it installed, but I don't on this machine.
	$package = Find-Package Microsoft.SqlServer.TransactSql.ScriptDom -Source https://www.nuget.org/api/v2
	$package \| Save-Package -Path $PWD
	$fileBaseName = $package.Name + '.' + $package.Version
	Rename-Item "$fileBaseName.nupkg" "$fileBaseName.zip"
	Expand-Archive "$fileBaseName.zip"
	Add-Type -Path $fileBaseName\lib\net40\Microsoft.SqlServer.TransactSql.ScriptDom.dll

	# Example from https://docs.microsoft.com/en-us/sql/t-sql/queries/select-examples-transact-sql
	$tSqlSample = @'