Skip to content

Commit

Permalink
Add doc comments to IScoreboardNicknamesService
Browse files Browse the repository at this point in the history
  • Loading branch information
araszka committed Sep 29, 2024
1 parent 876a74c commit 6b67864
Showing 1 changed file with 32 additions and 0 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -2,17 +2,49 @@

public interface IScoreboardNicknamesService
{
/// <summary>
/// Gets the online player by login and then sets their custom nickname in the repo.
/// </summary>
/// <param name="login"></param>
/// <returns></returns>
public Task AddNicknameByLoginAsync(string login);

/// <summary>
/// Clears the nicknames repo.
/// </summary>
/// <returns></returns>
public Task ClearNicknamesAsync();

/// <summary>
/// Gets all online players and sets their custom nicknames in the repo.
/// </summary>
/// <returns></returns>
public Task LoadNicknamesAsync();

/// <summary>
/// Sends the manialink containing the nicknames in the repo.
/// </summary>
/// <returns></returns>
public Task SendNicknamesManialinkAsync();

/// <summary>
/// Converts the nickname repo to a ManiaScript array.
/// </summary>
/// <param name="nicknameMap"></param>
/// <returns></returns>
public string ToManiaScriptArray(Dictionary<string, string> nicknameMap);

/// <summary>
/// Converts an entry of the nickname repo to a ManiaScript array entry.
/// </summary>
/// <param name="loginNickname"></param>
/// <returns></returns>
public string ToManiaScriptArrayEntry(KeyValuePair<string, string> loginNickname);

/// <summary>
/// Escapes a nickname to be safely inserted into a XMl comment.
/// </summary>
/// <param name="nickname"></param>
/// <returns></returns>
public string EscapeNickname(string nickname);
}

0 comments on commit 6b67864

Please sign in to comment.