Skip to content

Commit

Permalink
Add auto-doc workflow
Browse files Browse the repository at this point in the history
  • Loading branch information
Luzifix committed Jul 19, 2024
1 parent 02cdd11 commit b74fb44
Show file tree
Hide file tree
Showing 3 changed files with 33 additions and 0 deletions.
23 changes: 23 additions & 0 deletions .github/workflows/auto-doc.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
name: Automatic documentation
on:
push:
branches: [ "master" ]
pull_request:
branches: [ "master" ]

jobs:
auto-doc:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Setup .NET
uses: actions/setup-dotnet@v4
with:
dotnet-version: 8.x.x
- name: Restore dependencies
run: dotnet restore
- name: Build
run: dotnet build --no-restore -o build
- name: Automatic documentation
run: |
dotnet run --project Warcraft.NET.Docs/Warcraft.NET.Docs.csproj -- ../Docs
1 change: 1 addition & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -23,6 +23,7 @@ bld/
[Bb]in/
[Oo]bj/
[Ll]og/
build/

# Visual Studio 2015/2017 cache/options directory
.vs/
Expand Down
9 changes: 9 additions & 0 deletions Warcraft.NET.Docs/Program.cs
Original file line number Diff line number Diff line change
Expand Up @@ -10,15 +10,24 @@ internal class Program
/// <param name="args"></param>
static void Main(string[] args)
{
Console.WriteLine($"BaseDirectory: {AppDomain.CurrentDomain.BaseDirectory}");

if (args.Length == 0)
throw new System.Exception("Please provide an output folder");

string outputFolder = Path.GetFullPath(args[0]);
if (!Directory.Exists(outputFolder))
throw new Exception("Output folder does not exist");

Console.WriteLine($"Output folder: {outputFolder}");

Console.WriteLine("Generating documentation...");
var autoDocData = GenerateAutoDocDataStep.Process();

Console.WriteLine("Converting to markdown...");
ConvertToMarkdownStep.Process(autoDocData, outputFolder);

Console.WriteLine("Done!");
}
}
}

0 comments on commit b74fb44

Please sign in to comment.