Sorted API documentation

Author: jamesmcroft

.github/workflows/docs.yml

@@ -0,0 +1,53 @@
+name: Docs
+
+on:
+  push:
+    branches:
+    - main
+    paths:
+    - src/**
+    - docs/**
+    - .github/workflows/docs.yml
+  pull_request:
+    branches:
+    - main
+    paths:
+    - docs/**
+    - .github/workflows/docs.yml
+  workflow_dispatch:
+
+jobs:
+  generate-docs:
+
+    runs-on: windows-latest
+
+    steps:
+    - uses: actions/checkout@v2
+
+    - name: Setup .NET 5.0
+      uses: actions/setup-dotnet@v1
+      with:
+        dotnet-version: 5.0.x
+
+    - name: Setup .NET 6.0
+      uses: actions/setup-dotnet@v1
+      with:
+        dotnet-version: 6.0.x
+
+    - name: Setup DocFX
+      uses: crazy-max/ghaction-chocolatey@v1
+      with:
+        args: install docfx
+
+    - name: DocFX Build
+      working-directory: docs
+      run: docfx .\docfx.json
+      continue-on-error: false
+
+    - name: Publish
+      if: github.event_name == 'push'
+      uses: peaceiris/actions-gh-pages@v3
+      with:
+        github_token: ${{ secrets.GITHUB_TOKEN }}
+        publish_dir: docs/_site
+        force_orphan: true

.vscode/extensions.json

@@ -0,0 +1,4 @@
+{
+    "recommendations": [
+    ]
+}

.vscode/launch.json

@@ -0,0 +1,17 @@
+{
+  // Use IntelliSense to learn about possible attributes.
+  // Hover to view descriptions of existing attributes.
+  // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "name": "Run: Docs",
+      "preLaunchTask": "npm_install_docs",
+      "cwd": "${workspaceFolder}/docs",
+      "command": "npm run docfx",
+      "request": "launch",
+      "type": "node-terminal"
+    }
+  ],
+  "compounds": []
+}

.vscode/settings.json

@@ -0,0 +1,2 @@
+{
+}

.vscode/tasks.json

@@ -0,0 +1,12 @@
+{
+  "version": "2.0.0",
+  "tasks": [
+    {
+      "label": "npm_install_docs",
+      "type": "npm",
+      "script": "install",
+      "path": "docs/",
+      "problemMatcher": [],
+    }
+  ]
+}

docs/.gitignore

@@ -0,0 +1,9 @@
+###############
+#    folder   #
+###############
+/**/DROP/
+/**/TEMP/
+/**/packages/
+/**/bin/
+/**/obj/
+_site

docs/README.md

@@ -0,0 +1,29 @@
+# MADE Uno Documentation
+
+This folder contains source code for the generation of MADE Uno's documentation.
+
+## Contributing to the docs
+
+### Install dependencies
+
+Download and install docfx on your computer.
+
+#### MacOS
+
+```
+brew install docfx
+```
+
+#### Windows
+
+```
+choco install docfx
+```
+
+### Running locally
+
+```
+docfx .\docfx.json --serve
+```
+
+This will run the docs on `http://localhost:8080`

docs/api/.gitignore

@@ -0,0 +1,5 @@
+###############
+#  temp file  #
+###############
+*.yml
+.manifest

docs/api/index.md

@@ -0,0 +1,10 @@
+---
+uid: api-docs
+title: Explore the APIs
+---
+
+# Explore the APIs
+
+Here you'll find all of the generated code documentation for the MADE Uno projects, similar to what you might find on Microsoft Docs!
+
+This documentation is designed to show you how each component of MADE Uno is constructed and provide a reference for you when building your projects.

docs/articles/features/ui-controls-dropdownlist.md

@@ -0,0 +1,68 @@
+---
+uid: package-ui-controls-dropdownlist
+title: Using the DropDownList control
+---
+
+# Using the DropDownList control
+
+The `MADE.UI.Controls.DropDownList` element is a custom-built UI element for Windows (UWP) applications that provides a selection user experience, allowing a user to select one or multiple items from a list.
+
+The control works in a similar way to the `ComboBox` element in the Windows SDK, with the added extensibility to change modes to select multiple items.
+
+Shown below is the visuals for the control in its default state, in a multiple selection mode.
+
+<img src="../../images/MultiSelectDropDownListCollapsed.png" alt="DropDownList control showing multiple selected items" />
+
+<img src="../../images/MultiSelectDropDownListExpanded.png" alt="DropDownList control showing expanded selection with selected items" />
+
+## Example usage
+
+```xml
+<Page
+    x:Class="DropDownListSample.MainPage"
+    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
+    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
+    xmlns:controls="using:MADE.UI.Controls"
+    xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
+    xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
+    Background="{ThemeResource ApplicationPageBackgroundThemeBrush}"
+    mc:Ignorable="d">
+
+    <RelativePanel Padding="12">
+        <controls:DropDownList
+            x:Name="DropDownList"
+            Header="MultiDropDownList"
+            ItemsSource="{x:Bind ViewModel.ItemCollection}"
+            RelativePanel.AlignLeftWithPanel="True"
+            RelativePanel.AlignRightWithPanel="True"
+            RelativePanel.AlignTopWithPanel="True"
+            SelectionMode="Multiple" />
+    </RelativePanel>
+</Page>
+```
+
+## Customizing the DropDownList
+
+The control has many customization properties that are exposed to tailor the experience for your application. 
+
+### HeaderTemplate
+
+The `Header` can be customized to include custom UI elements as well as a string resource.
+
+The `HeaderTemplate` is also available to provide a `DataTemplate` for you to define the rendered UI for the `Header`.
+
+### ItemTemplate and ItemTemplateSelector
+
+The rendered UI elements for the items in the control can be customized with the `ItemTemplate` or `ItemTemplateSelector`.
+
+### SelectionMode
+
+The `DropDownList` has two selection modes, `Single` and `Multiple`. 
+
+By default, the control works in a `Single` selection mode. 
+
+### MaxDropDownHeight
+
+The height of the drop-down can be customized to allow you to show more results that the default expanded view. 
+
+By default, the drop down will expand to 248 pixels.