NF.Tool.ReleaseNoteMaker

• https://github.com/netpyoung/NF.Tool.ReleaseNoteMaker

시작하며

• 히스토리에서 뽑는건 별로
• ADR같은 도구가 있으면 좋겠다.
  • towncrier을 찾았다.

기록

• 렌더템플릿 및 라이브러리 선택

  • towncrier는 Jinja2
  • liquid / razor / t4
    • 디버깅 가능한걸로
    • mono t4 디버깅 꽤 괜찮네, 근데 string넘기는게 아니라 filepath라 찝찝

• AnsiConsole

  • public override string StackTrace { get; } 안먹히는것.
    • 이슈를 일단 남김 - https://github.com/spectreconsole/spectre.console/issues/1692
  • stderr AnsiConsole 어떻게 처리할고
  • MultiSelectionPrompt 해서 키를 입력받아 캔슬 넣고싶었는데 캔슬이 없네?
    • Select는 있는데 SelectAll/DeselectAll이 없네
    • https://github.com/spectreconsole/spectre.console/discussions/700
  • 최대길이
    • AnsiConsole.Profile.Width = 255;

• towncrier

  • 다이나믹 언어 타입 및 네이밍 문제 - 저쪽 세상 네이밍 센스 맘에 안듬.

• assemblyLocation empty

  • <IncludeAllContentForSelfExtract>true</IncludeAllContentForSelfExtract>
  • 이 옵션을 사용하면 애플리케이션의 모든 콘텐츠 파일(예: DLL, 구성 파일, 리소스 파일 등)이 실행 파일 내에 포함되어 실행 파일을 실행하면 자동으로 추출되고 실행됩니다.
  • https://learn.microsoft.com/en-us/dotnet/core/deploying/single-file/overview?tabs=cli

• PatchNoteMaker 했는데... ReleaseNoteMaker 도 있는데...

  • PatchNoteMaker했다가 최종적으로 ReleaseNoteMaker로 결정.

• Tomlyn 사용법

  • array를 키를 지정해서 dic으로 넣는 기능이 있으면 좋을것같은데...

• 집합연산 까먹네

  • https://learn.microsoft.com/en-us/dotnet/csharp/linq/standard-query-operators/set-operations
  • 표로 정리했다가 그냥 그때그때 검색하자. 나중에 필요하면 다시 표로정리.

• public void Deconstruct(out string fname, out string lname)

  • https://learn.microsoft.com/en-us/dotnet/csharp/fundamentals/functional/deconstruct#user-defined-types

• 구조체 생성자 방지

  • public ObsoleteAttribute(string? message, bool error)
    • throw new InvalidOperationException

• line ending 문제

  • https://en.wikipedia.org/wiki/Newline

• TestInitialize/TestCleanup/DeploymentItem/TestMethod

  • DeploymentItem들이 TestInitialize보다 먼저 실행되는데 막상 TestContext.DeploymentDirectory는 동일해서 파일조작 테스트는 오작동을 일으킬 가능성이 생김.
  • public required TestContext TestContext { get; set; } 로 가져와서 시작시 폴더이동.

• liquid

  • fluid / scriban / dotliquid
    • dotliquid는 Drop만드는게 귀찮아서 패스
    • https://github.com/microsoft/semantic-kernel/issues/6233 에서 scriban대신 fluid쓰는거보고 fluid로 선택
  • liquid를 지원했으나 whitespace관리가 어렵고 fluid에서 class의 method호출이 안되었다.
    • 안되서 {%- assign categoryIssues = category.GetAllIssues() -%}
    • 이렇게 함 {%- assign categoryIssues = category.CategoryIssues -%}

• docfx

  • [!INCLUDE [<title>](<filepath>)]
    • https://dotnet.github.io/docfx/docs/markdown.html?q=include&tabs=linux%2Cdotnet#include-markdown-files
  • [!code-<language>[](<filepath><query-options>)]
    • https://dotnet.github.io/docfx/docs/markdown.html?q=include&tabs=linux%2Cdotnet#code-snippet
  • mermaid
    • https://dotnet.github.io/docfx/docs/markdown.html?tabs=linux%2Cdotnet#mermaid-diagrams
  • NOTE / TIP / IMPORTANT / CAUTION / WARNING
    • https://dotnet.github.io/docfx/docs/markdown.html?tabs=linux%2Cdotnet#alerts

> [!NOTE]
> Information the user should notice even if skimming.

• pack 시 define flag를 알 수 없네..
  • https://github.com/dotnet/sdk/issues/26324, https://github.com/dotnet/sdk/issues/10402
• reno라는 것도 있네?
  • https://github.com/openstack/reno
  • https://docs.openstack.org/reno/latest/

잡다한

• filename => fileName
• https://stackoverflow.com/questions/159017/named-string-formatting-in-c-sharp
• python textwrap
• https://learn.microsoft.com/en-us/dotnet/csharp/language-reference/proposals/csharp-11.0/raw-string-literal
• 러스트로 작성된 것도 있네?
  • https://github.com/nekitdev/changelogging
    • draft대신 preview라는 명령어를 넣은건 좋은듯. https://docs.rs/changelogging/latest/changelogging/#preview