Skip to content

Commit f21eb5d

Browse files
committed
Add XML documentation for all public members
1 parent 4c41acd commit f21eb5d

File tree

3 files changed

+25
-1
lines changed

3 files changed

+25
-1
lines changed

src/dbup-clickhouse/ClickHouseExtensions.cs

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,19 @@
33

44
namespace DbUp.ClickHouse;
55

6+
/// <summary>
7+
/// Configuration extension methods for ClickHouse.
8+
/// </summary>
69
public static class ClickHouseExtensions
710
{
11+
/// <summary>
12+
/// Creates an upgrader for ClickHouse databases.
13+
/// </summary>
14+
/// <param name="supportedDatabases">Fluent helper type.</param>
15+
/// <param name="connectionString">ClickHouse database connection string.</param>
16+
/// <returns>
17+
/// A builder for a database upgrader designed for ClickHouse databases.
18+
/// </returns>
819
public static UpgradeEngineBuilder ClickHouseDatabase(this SupportedDatabases supportedDatabases, string connectionString)
920
{
1021
throw new NotImplementedException();

src/dbup-clickhouse/ClickHouseJournal.cs

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,15 @@
66

77
namespace DbUp.ClickHouse;
88

9+
/// <summary>
10+
/// An implementation of the <see cref="IJournal"/> interface for ClickHouse databases.
11+
/// </summary>
12+
/// <remarks>
13+
/// Initializes a new instance of the <see cref="ClickHouseJournal"/> class.
14+
/// </remarks>
15+
/// <param name="connectionManagerFactory">The connection manager factory.</param>
16+
/// <param name="logFactory">The log factory.</param>
17+
/// <param name="tableName">The name of the table.</param>
918
public class ClickHouseJournal(
1019
// Remove pragma once implemented
1120
#pragma warning disable CS9113 // Parameter is unread.
@@ -15,9 +24,12 @@ string tableName
1524
#pragma warning restore CS9113 // Parameter is unread.
1625
) : IJournal
1726
{
27+
/// <inheritdoc/>
1828
public string[] GetExecutedScripts() => throw new NotImplementedException();
1929

30+
/// <inheritdoc/>
2031
public void StoreExecutedScript(SqlScript script, Func<IDbCommand> dbCommandFactory) => throw new NotImplementedException();
2132

33+
/// <inheritdoc/>
2234
public void EnsureTableExistsAndIsLatestVersion(Func<IDbCommand> dbCommandFactory) => throw new NotImplementedException();
2335
}

src/dbup-clickhouse/dbup-clickhouse.csproj

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<Project Sdk="Microsoft.NET.Sdk">
1+
<Project Sdk="Microsoft.NET.Sdk">
22

33
<PropertyGroup>
44
<Description>DbUp makes it easy to deploy and upgrade SQL Server databases. This package adds ClickHouse support.</Description>
@@ -14,6 +14,7 @@
1414
<SignAssembly>true</SignAssembly>
1515
<RepositoryUrl>https://github.com/DbUp/dbup-clickhouse.git</RepositoryUrl>
1616
<PackageIcon>dbup-icon.png</PackageIcon>
17+
<GenerateDocumentationFile>true</GenerateDocumentationFile>
1718
</PropertyGroup>
1819

1920
<ItemGroup>

0 commit comments

Comments
 (0)