danielgerlag/workflow-core

Add documentation to the actual code

開放

#1,308 建立於 2024年10月14日

 (0 則留言) (1 個反應) (0 位負責人)C# (1,263 個分叉)batch import
help wanted

倉庫指標

星標
 (5,914 顆星)
PR 合併指標
 (30 天內沒有已合併 PR)

描述

Is your feature request related to a problem? Please describe. First of all thank you for even creating the library. I couldn't help but notice unfortunately that the usage of this library is mainly documented in samples and some ReadTheDocs but not a lot of documentation about any of the methods exists in the actual code. This makes working with the library more difficult than it has to be because one essentially needs to dig into the source code to understand what some things actually do.

CancelCondition is one example. I expected its a condition that is checked once at its point in the workflow whether the workflow should cancel at this point, seems it is checked regularly throughout the workflow. But can also be used to cancel parallel workflows as per some release notes?

Describe the solution you'd like Add documentation to at least all the public facing methods that describe properly what they do and also add an example usage in there.

Describe alternatives you've considered Trawl through the source code to gather this information myself. I've done this now and its really not efficient.

貢獻者指南