Updated README
This commit is contained in:
@@ -17,8 +17,12 @@
|
|||||||
</PropertyGroup>
|
</PropertyGroup>
|
||||||
|
|
||||||
<ItemGroup>
|
<ItemGroup>
|
||||||
<None Include="README.md" Pack="true" PackagePath="\" />
|
<None Include="README.md" Pack="true" PackagePath="\">
|
||||||
<None Include="CHANGELOG.md" Pack="true" PackagePath="\" />
|
<CopyToOutputDirectory>Always</CopyToOutputDirectory>
|
||||||
|
</None>
|
||||||
|
<None Include="CHANGELOG.md" Pack="true" PackagePath="\">
|
||||||
|
<CopyToOutputDirectory>Always</CopyToOutputDirectory>
|
||||||
|
</None>
|
||||||
<None Include="LICENSE.md" Pack="true" PackagePath="\" />
|
<None Include="LICENSE.md" Pack="true" PackagePath="\" />
|
||||||
</ItemGroup>
|
</ItemGroup>
|
||||||
|
|
||||||
|
|||||||
@@ -11,7 +11,7 @@ using OmegaLeo.HelperLib.Documentation.Models;
|
|||||||
namespace OmegaLeo.HelperLib.Documentation.Helpers
|
namespace OmegaLeo.HelperLib.Documentation.Helpers
|
||||||
{
|
{
|
||||||
|
|
||||||
[Changelog("1.2.0", "Migrated DocumentationHelper library from NetFlow.DocumentationHelper.Library to it's own package in OmegaLeo.HelperLib")]
|
[Changelog("1.2.0", "Migrated DocumentationHelper library from NetFlow.DocumentationHelper.Library to it's own package in OmegaLeo.HelperLib", "January 26, 2026")]
|
||||||
public static class DocumentationHelperTool
|
public static class DocumentationHelperTool
|
||||||
{
|
{
|
||||||
[Documentation("GenerateDocumentation (bool generateForPackageAssembly)",
|
[Documentation("GenerateDocumentation (bool generateForPackageAssembly)",
|
||||||
|
|||||||
@@ -25,5 +25,13 @@
|
|||||||
<ItemGroup>
|
<ItemGroup>
|
||||||
<ProjectReference Include="..\OmegaLeo.HelperLib.Shared\OmegaLeo.HelperLib.Shared.csproj" />
|
<ProjectReference Include="..\OmegaLeo.HelperLib.Shared\OmegaLeo.HelperLib.Shared.csproj" />
|
||||||
</ItemGroup>
|
</ItemGroup>
|
||||||
|
<ItemGroup>
|
||||||
|
<None Update="README.md">
|
||||||
|
<CopyToOutputDirectory>Always</CopyToOutputDirectory>
|
||||||
|
</None>
|
||||||
|
<None Update="CHANGELOG.md">
|
||||||
|
<CopyToOutputDirectory>Always</CopyToOutputDirectory>
|
||||||
|
</None>
|
||||||
|
</ItemGroup>
|
||||||
|
|
||||||
</Project>
|
</Project>
|
||||||
|
|||||||
@@ -0,0 +1,30 @@
|
|||||||
|
# Omega Leo's Helper Library - Documentation
|
||||||
|
Package to help with generating and managing documentation for your C# projects.
|
||||||
|
|
||||||
|
## Features
|
||||||
|
- Attribute-based documentation: Use custom attributes to annotate your classes, methods, and properties with documentation comments.
|
||||||
|
- Documentation extraction tool: A tool to extract and format documentation into various formats (Markdown, HTML, etc.).
|
||||||
|
- Integration with build processes: Easily integrate documentation generation into your CI/CD pipelines.
|
||||||
|
|
||||||
|
## Example attribute usage:
|
||||||
|
```cs
|
||||||
|
[Documentation("GenerateDocumentation (bool generateForPackageAssembly)",
|
||||||
|
@"Generates a List of objects of type DocumentationStructure that contain the following fields:
|
||||||
|
**AssemblyName**: Name of the main Assembly, used to identify the root namespace
|
||||||
|
**ClassName**: Name of the class, used to identify the upper level object
|
||||||
|
**Title**: Title what we're generating documentation for
|
||||||
|
**Description**: Description of what we're generating documentation for, this can contain usage examples and can use the args array to pass names(e.g.: This method uses this methodology)
|
||||||
|
**Args**: Array of strings that describe the parameters of the method or class
|
||||||
|
**CodeExample**: A code example of how to use the method or class
|
||||||
|
|
||||||
|
*Note: If generateForPackageAssembly is set to true, this will generate documentation for the library as well.*",
|
||||||
|
new []
|
||||||
|
{
|
||||||
|
"generateForPackageAssembly - Generate documentation for the DocumentationHelper library as well?"
|
||||||
|
},
|
||||||
|
@"```csharp
|
||||||
|
DocumentationHelperTool.GenerateDocumentation(true); // Generates documentation for all assemblies including the DocumentationHelper.Library package assembly
|
||||||
|
DocumentationHelperTool.GenerateDocumentation(false); // Generates documentation for all assemblies excluding the DocumentationHelper.Library package assembly
|
||||||
|
```")]
|
||||||
|
public static IEnumerable<DocumentationStructure> GenerateDocumentation(bool generateForPackageAssembly = false)
|
||||||
|
```
|
||||||
@@ -22,4 +22,13 @@
|
|||||||
<PackageReference Include="Newtonsoft.Json" Version="13.0.4" />
|
<PackageReference Include="Newtonsoft.Json" Version="13.0.4" />
|
||||||
</ItemGroup>
|
</ItemGroup>
|
||||||
|
|
||||||
|
<ItemGroup>
|
||||||
|
<None Update="README.md">
|
||||||
|
<CopyToOutputDirectory>Always</CopyToOutputDirectory>
|
||||||
|
</None>
|
||||||
|
<None Update="CHANGELOG.md">
|
||||||
|
<CopyToOutputDirectory>Always</CopyToOutputDirectory>
|
||||||
|
</None>
|
||||||
|
</ItemGroup>
|
||||||
|
|
||||||
</Project>
|
</Project>
|
||||||
|
|||||||
@@ -1 +0,0 @@
|
|||||||
# OmegaLeo's Helper Library - Game Logic
|
|
||||||
Executable
+8
@@ -0,0 +1,8 @@
|
|||||||
|
# OmegaLeo's Helper Library - Game Logic
|
||||||
|
Lightweight utility library for C# projects and game development helpers.
|
||||||
|
|
||||||
|
## Features
|
||||||
|
- Game development specific helpers and utilities
|
||||||
|
- Helpers for common game development tasks
|
||||||
|
- Easy to integrate into existing projects
|
||||||
|
- Open source under the AGPL v3 License
|
||||||
@@ -18,8 +18,12 @@
|
|||||||
</PropertyGroup>
|
</PropertyGroup>
|
||||||
|
|
||||||
<ItemGroup>
|
<ItemGroup>
|
||||||
<None Include="README.md" Pack="true" PackagePath="\"/>
|
<None Include="README.md" Pack="true" PackagePath="\">
|
||||||
<None Include="CHANGELOG.md" Pack="true" PackagePath="\"/>
|
<CopyToOutputDirectory>Always</CopyToOutputDirectory>
|
||||||
|
</None>
|
||||||
|
<None Include="CHANGELOG.md" Pack="true" PackagePath="\">
|
||||||
|
<CopyToOutputDirectory>Always</CopyToOutputDirectory>
|
||||||
|
</None>
|
||||||
<None Include="LICENSE.md" Pack="true" PackagePath="\"/>
|
<None Include="LICENSE.md" Pack="true" PackagePath="\"/>
|
||||||
</ItemGroup>
|
</ItemGroup>
|
||||||
|
|
||||||
|
|||||||
@@ -1 +1 @@
|
|||||||
# Omega Leo's Helper Lib
|
# Omega Leo's Helper Library
|
||||||
Reference in New Issue
Block a user