diff --git a/404.html b/404.html index 793e9d0..4c0489d 100644 --- a/404.html +++ b/404.html @@ -1514,7 +1514,7 @@ - + diff --git a/index.html b/index.html index 4bb479c..d7e6ff8 100644 --- a/index.html +++ b/index.html @@ -730,7 +730,7 @@ - + - + \ No newline at end of file diff --git a/krontab/describing/string-format.html b/krontab/describing/string-format.html index e8d82a7..5bf2d70 100644 --- a/krontab/describing/string-format.html +++ b/krontab/describing/string-format.html @@ -874,7 +874,7 @@ - + \ No newline at end of file diff --git a/krontab/index.html b/krontab/index.html index 9dda3aa..694250a 100644 --- a/krontab/index.html +++ b/krontab/index.html @@ -852,7 +852,7 @@ scheduler is not instance of KronSchedulerTz it will work like you - + \ No newline at end of file diff --git a/krontab/introduction/faq.html b/krontab/introduction/faq.html index 27d14ff..37658a2 100644 --- a/krontab/introduction/faq.html +++ b/krontab/introduction/faq.html @@ -674,7 +674,7 @@ - + \ No newline at end of file diff --git a/krontab/introduction/how-to-use.html b/krontab/introduction/how-to-use.html index 6daabad..d502cc8 100644 --- a/krontab/introduction/how-to-use.html +++ b/krontab/introduction/how-to-use.html @@ -740,7 +740,7 @@ - + \ No newline at end of file diff --git a/krontab/introduction/including-in-project.html b/krontab/introduction/including-in-project.html index 8903e95..587e775 100644 --- a/krontab/introduction/including-in-project.html +++ b/krontab/introduction/including-in-project.html @@ -720,7 +720,7 @@ - + \ No newline at end of file diff --git a/kslog/index.html b/kslog/index.html index b3fd204..8f766d7 100644 --- a/kslog/index.html +++ b/kslog/index.html @@ -727,7 +727,7 @@ - + \ No newline at end of file diff --git a/kslog/logging.html b/kslog/logging.html index 0972743..5406ad7 100644 --- a/kslog/logging.html +++ b/kslog/logging.html @@ -777,7 +777,7 @@ On this page all the messages will be just simple String, but you m - + \ No newline at end of file diff --git a/kslog/setup.html b/kslog/setup.html index faf3c20..d886bfa 100644 --- a/kslog/setup.html +++ b/kslog/setup.html @@ -875,7 +875,7 @@ - + \ No newline at end of file diff --git a/micro_utils/index.html b/micro_utils/index.html index a174dce..816d79c 100644 --- a/micro_utils/index.html +++ b/micro_utils/index.html @@ -634,7 +634,7 @@ me directly in my telegram

- + \ No newline at end of file diff --git a/navigation/index.html b/navigation/index.html index f675fd9..4ae140f 100644 --- a/navigation/index.html +++ b/navigation/index.html @@ -538,9 +538,28 @@ @@ -562,59 +581,307 @@ important terms:

  • Node - is a core thing. Node itself contains current config and its state
  • Chain - some sequence of nodes. In one chain only the last one node can be active
    • -

    Nodes tree

    +

    Work explanation

    + +
    +Info +

    There are 3 statuses:

    + +

    In fact node will retrieve 6 changes of statuses:

    +
    flowchart TB + New -.-> Create + Create -.-> Created + Created -.-> Start -.-> Started + Started --> Resume --> Resumed + Resumed --> Pause --> Started + Started --> Stop --> Created + Created --> Destroy + Destroy --> New + + DashedLineLegendTitle(Dashed line) -.-> DashedLineLegend(Possible direction before `Created` state) + SolidLineLegendTitle(Solid line) --> SolidLineLegend(Possible direction after `Created` state) + + class New navigation-new; + class Destroyed navigation-new; + class Created navigation-created; + class Started navigation-started; + class Resumed navigation-resumed; +
    +
    +
    +

    Nodes behaviour

    Let’s see the next sample:

    +
    flowchart LR + subgraph Nodes/Chains tree + NodeN1(N1) + NodeN2(N2) + + class NodeN1 navigation-started; + class NodeN2 navigation-resumed; + + subgraph RootChain + direction LR + NodeN1 --> NodeN2 + end + + class RootChain navigation-resumed; + end +
    +

    we may say several things about the sample above:

    + +

    So, we would like to add new node in the end of stack:

    +
    flowchart LR + subgraph Nodes/Chains tree + NodeN1(N1) + NodeN2(N2) + NodeN3(N3) + + class NodeN1 navigation-started; + class NodeN2 navigation-started; + class NodeN3 navigation-resumed; + + subgraph RootChain + direction LR + NodeN1 --> NodeN2 + NodeN2 --> NodeN3 + end + + class RootChain navigation-resumed; + end +
    +

    As we can see, N3 became RESUMED and N2 PAUSED. Let’s try to remove N3:

    +
    flowchart LR + subgraph Nodes/Chains tree + NodeN1(N1) + NodeN2(N2) + + class NodeN1 navigation-started; + class NodeN2 navigation-resumed; + + subgraph RootChain + direction LR + NodeN1 --> NodeN2 + end + + class RootChain navigation-resumed; + end +
    +

    Chains behaviour

    +

    So, let’s continue with the sample above. Let’s imagine, we need to add new subchain for N2 node. +Whole tree will look like:

    +
    flowchart LR + subgraph Nodes/Chains tree + direction LR + + NodeN1(N1) + NodeN2(N2) + NodeN3(N3) + + class NodeN1 navigation-started; + class NodeN2 navigation-resumed; + class NodeN3 navigation-resumed; + + subgraph RootChain + direction LR + NodeN1 --> NodeN2 + NodeN2 + end + + NodeN2 --> N2Subchain + + subgraph N2Subchain + direction LR + NodeN3 + end + + class RootChain navigation-resumed; + class N2Subchain navigation-resumed; + end +
    +

    Here has been created new N2Subchain with N3 node. Both them resumed because of:

    + +

    We may add new subchain to N1:

    +
    flowchart LR + subgraph Nodes/Chains tree + direction LR + NodeN1(N1) + NodeN2(N2) + NodeN3(N3) + NodeN4(N4) + + class NodeN1 navigation-started; + class NodeN2 navigation-resumed; + class NodeN3 navigation-resumed; + class NodeN4 navigation-started; + + subgraph RootChain + direction LR + NodeN1 --> NodeN2 + NodeN2 + end + + NodeN1 --> N1Subchain + NodeN2 --> N2Subchain + + subgraph N1Subchain + direction LR + NodeN4 + end + + subgraph N2Subchain + direction LR + NodeN3 + end + + class RootChain navigation-resumed; + + class N1Subchain navigation-started; + class N2Subchain navigation-resumed; + end +
    +

    So, it has been added, but:

    + +

    And now we may remove N2 node. This action will trigger next changes:

    +
    flowchart LR + subgraph Changes + subgraph OldNodesChainsTree [Old Nodes/Chains tree] + direction TB + OldNodeN1(N1) + OldNodeN2(N2) + OldNodeN3(N3) + OldNodeN4(N4) + + class OldNodeN1 navigation-started; + class OldNodeN2 navigation-created; + class OldNodeN3 navigation-created; + class OldNodeN4 navigation-started; + + subgraph OldRootChain [RootChain] + direction TB + OldNodeN1 --> OldNodeN2 + OldNodeN2 + end + + OldNodeN1 --> OldN1Subchain + OldNodeN2 --> OldN2Subchain + + subgraph OldN1Subchain [N1Subchain] + direction TB + OldNodeN4 + end + + subgraph OldN2Subchain [N2Subchain] + direction TB + OldNodeN3 + end + + class OldRootChain navigation-resumed; + + class OldN1Subchain navigation-started; + class OldN2Subchain navigation-created; + end + + subgraph NewNodesChainsTree [New Nodes/Chains tree] + direction TB + NewNodeN1(N1) + NewNodeN4(N4) + + class NewNodeN1 navigation-resumed; + class NewNodeN4 navigation-resumed; + + subgraph NewRootChain [RootChain] + direction TB + NewNodeN1 + end + + NewNodeN1 ---> NewN1Subchain + + subgraph NewN1Subchain [N1Subchain] + direction TB + NewNodeN4 + end + + class NewRootChain navigation-resumed; + + class NewN1Subchain navigation-resumed; + end + +%% OldNodesChainsTree -.-> NewNodesChainsTree + OldNodeN1-.->|Become resumed| NewNodeN1 + OldNodeN4-.->|Become resumed| NewNodeN4 + + end +
    +

    What has happened:

    +
      +
    1. We solved to remove N2 node. Status is changing to stopped
      2. +
    2. N2Subchain must be stopped
      3. +
    3. N3 must be stopped as well
      4. +
    +
    +

    Stopping in context of navigation means destroying

    +
    +

    Large tree sample

    flowchart TB NodeN1(N1) NodeN2(N2) NodeN3(N3) - class NodeN1 navigation-paused; - class NodeN1 navigation-part; - class NodeN2 navigation-paused; - class NodeN2 navigation-part; + class NodeN1 navigation-started; + class NodeN2 navigation-started; class NodeN3 navigation-resumed; - class NodeN3 navigation-part; subgraph RootChain direction TB - NodeN1 --> NodeN2 - NodeN2 --> NodeN3 + NodeN1-->NodeN2 + NodeN2-->NodeN3 end class RootChain navigation-resumed; - class RootChain navigation-part; NodeN4(N4) NodeN5(N5) NodeN6(N6) - class NodeN4 navigation-paused; - class NodeN4 navigation-part; - class NodeN5 navigation-paused; - class NodeN5 navigation-part; - class NodeN6 navigation-paused; - class NodeN6 navigation-part; + class NodeN4 navigation-started; + class NodeN5 navigation-started; + class NodeN6 navigation-started; subgraph N2Subchain direction TB - NodeN4 --> NodeN5 - NodeN5 --> NodeN6 + NodeN4-->NodeN5 + NodeN5-->NodeN6 end - class N2Subchain navigation-paused; - class N2Subchain navigation-part; + class N2Subchain navigation-started; NodeN2 --> N2Subchain NodeN7(N7) NodeN8(N8) - class NodeN7 navigation-paused; - class NodeN7 navigation-part; + class NodeN7 navigation-started; class NodeN8 navigation-resumed; - class NodeN8 navigation-part; subgraph N3Subchain direction TB @@ -622,17 +889,14 @@ important terms:

    end class N3Subchain navigation-resumed; - class N3Subchain navigation-part; NodeN3 --> N3Subchain NodeN9(N9) NodeN10(N10) - class NodeN9 navigation-paused; - class NodeN9 navigation-part; + class NodeN9 navigation-started; class NodeN10 navigation-resumed; - class NodeN10 navigation-part; subgraph N3Subchain2 direction TB @@ -640,11 +904,9 @@ important terms:

    end class N3Subchain2 navigation-resumed; - class N3Subchain2 navigation-part; NodeN3 --> N3Subchain2
    -

    Any hierarchy starts with some root chain.

    @@ -702,7 +964,7 @@ important terms:

    - + - + \ No newline at end of file diff --git a/tgbotapi/dsls/live-location.html b/tgbotapi/dsls/live-location.html index f6a3156..36b495e 100644 --- a/tgbotapi/dsls/live-location.html +++ b/tgbotapi/dsls/live-location.html @@ -730,7 +730,7 @@ OR - + \ No newline at end of file diff --git a/tgbotapi/dsls/text.html b/tgbotapi/dsls/text.html index 77e990e..2d6a578 100644 --- a/tgbotapi/dsls/text.html +++ b/tgbotapi/dsls/text.html @@ -634,7 +634,7 @@ - + \ No newline at end of file diff --git a/tgbotapi/faq.html b/tgbotapi/faq.html index eb57116..5ed39cd 100644 --- a/tgbotapi/faq.html +++ b/tgbotapi/faq.html @@ -704,7 +704,7 @@ and pass there updatesUpstreamFlow parameter with any operations ov - + \ No newline at end of file diff --git a/tgbotapi/guides/keyboards.html b/tgbotapi/guides/keyboards.html index 8e80f62..3648821 100644 --- a/tgbotapi/guides/keyboards.html +++ b/tgbotapi/guides/keyboards.html @@ -1168,7 +1168,7 @@ In both scenarios the bot receives an update of a corresponding type and has to - + \ No newline at end of file diff --git a/tgbotapi/index.html b/tgbotapi/index.html index eb49b30..4a17558 100644 --- a/tgbotapi/index.html +++ b/tgbotapi/index.html @@ -749,7 +749,7 @@ always welcome in our - + \ No newline at end of file diff --git a/tgbotapi/introduction/before-any-bot-project.html b/tgbotapi/introduction/before-any-bot-project.html index 2ff29a9..e39a260 100644 --- a/tgbotapi/introduction/before-any-bot-project.html +++ b/tgbotapi/introduction/before-any-bot-project.html @@ -655,7 +655,7 @@ - + \ No newline at end of file diff --git a/tgbotapi/introduction/first-bot.html b/tgbotapi/introduction/first-bot.html index fd3628f..2d8dd2a 100644 --- a/tgbotapi/introduction/first-bot.html +++ b/tgbotapi/introduction/first-bot.html @@ -671,7 +671,7 @@ A lot of examples with using of Telegram Bot API you can find in {"base": "../..", "features": ["announce.dismiss", "content.action.edit", "content.action.view", "content.code.annotate", "content.code.copy", "content.tooltips", "navigation.footer", "navigation.indexes", "navigation.sections", "navigation.tabs", "navigation.top", "navigation.tracking", "search.highlight", "search.share", "search.suggest", "toc.follow"], "search": "../../assets/javascripts/workers/search.74e28a9f.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}} - + \ No newline at end of file diff --git a/tgbotapi/introduction/including-in-your-project.html b/tgbotapi/introduction/including-in-your-project.html index 281fb36..8894408 100644 --- a/tgbotapi/introduction/including-in-your-project.html +++ b/tgbotapi/introduction/including-in-your-project.html @@ -944,7 +944,7 @@ - + \ No newline at end of file diff --git a/tgbotapi/introduction/proxy-setup.html b/tgbotapi/introduction/proxy-setup.html index 49e0008..6f6de15 100644 --- a/tgbotapi/introduction/proxy-setup.html +++ b/tgbotapi/introduction/proxy-setup.html @@ -704,7 +704,7 @@ In the snippet above was used version 2.0.1 which is actual for - + \ No newline at end of file diff --git a/tgbotapi/logic/api-extensions.html b/tgbotapi/logic/api-extensions.html index a01b8cc..88a50cc 100644 --- a/tgbotapi/logic/api-extensions.html +++ b/tgbotapi/logic/api-extensions.html @@ -701,7 +701,7 @@ - + \ No newline at end of file diff --git a/tgbotapi/logic/behaviour-builder-with-fsm.html b/tgbotapi/logic/behaviour-builder-with-fsm.html index 10c2216..7a1f2ff 100644 --- a/tgbotapi/logic/behaviour-builder-with-fsm.html +++ b/tgbotapi/logic/behaviour-builder-with-fsm.html @@ -709,7 +709,7 @@ You may find full example of FSM usage in {"base": "../..", "features": ["announce.dismiss", "content.action.edit", "content.action.view", "content.code.annotate", "content.code.copy", "content.tooltips", "navigation.footer", "navigation.indexes", "navigation.sections", "navigation.tabs", "navigation.top", "navigation.tracking", "search.highlight", "search.share", "search.suggest", "toc.follow"], "search": "../../assets/javascripts/workers/search.74e28a9f.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}} - + \ No newline at end of file diff --git a/tgbotapi/logic/behaviour-builder.html b/tgbotapi/logic/behaviour-builder.html index 9df2626..ccdce3c 100644 --- a/tgbotapi/logic/behaviour-builder.html +++ b/tgbotapi/logic/behaviour-builder.html @@ -719,7 +719,7 @@ - + \ No newline at end of file diff --git a/tgbotapi/logic/exceptions-handling.html b/tgbotapi/logic/exceptions-handling.html index f80efa2..6cc694a 100644 --- a/tgbotapi/logic/exceptions-handling.html +++ b/tgbotapi/logic/exceptions-handling.html @@ -768,7 +768,7 @@ - + \ No newline at end of file diff --git a/tgbotapi/logic/files-handling.html b/tgbotapi/logic/files-handling.html index ba2f937..b74a460 100644 --- a/tgbotapi/logic/files-handling.html +++ b/tgbotapi/logic/files-handling.html @@ -735,7 +735,7 @@ Sending via file is accessible from all supported platforms, but there is small - + \ No newline at end of file diff --git a/tgbotapi/logic/low-level-work-with-bots.html b/tgbotapi/logic/low-level-work-with-bots.html index 548df7f..ab78142 100644 --- a/tgbotapi/logic/low-level-work-with-bots.html +++ b/tgbotapi/logic/low-level-work-with-bots.html @@ -633,7 +633,7 @@ - + \ No newline at end of file diff --git a/tgbotapi/logic/media-groups.html b/tgbotapi/logic/media-groups.html index d194b03..2d9308e 100644 --- a/tgbotapi/logic/media-groups.html +++ b/tgbotapi/logic/media-groups.html @@ -687,7 +687,7 @@ In tgbotapi there is no any additional handling of media groups by default and i - + \ No newline at end of file diff --git a/tgbotapi/logic/types-conversations.html b/tgbotapi/logic/types-conversations.html index 2cee2f9..f04b6a9 100644 --- a/tgbotapi/logic/types-conversations.html +++ b/tgbotapi/logic/types-conversations.html @@ -687,7 +687,7 @@ - + \ No newline at end of file diff --git a/tgbotapi/logic/updates-with-flows.html b/tgbotapi/logic/updates-with-flows.html index 3233690..8ea8223 100644 --- a/tgbotapi/logic/updates-with-flows.html +++ b/tgbotapi/logic/updates-with-flows.html @@ -711,7 +711,7 @@ - + \ No newline at end of file diff --git a/tgbotapi/updates/heroku.html b/tgbotapi/updates/heroku.html index a266343..57375ee 100644 --- a/tgbotapi/updates/heroku.html +++ b/tgbotapi/updates/heroku.html @@ -750,7 +750,7 @@ Here will be presented variants of configuration of webhooks and starting server - + \ No newline at end of file diff --git a/tgbotapi/updates/long-polling.html b/tgbotapi/updates/long-polling.html index 81732fc..13e28cc 100644 --- a/tgbotapi/updates/long-polling.html +++ b/tgbotapi/updates/long-polling.html @@ -742,7 +742,7 @@ - + \ No newline at end of file diff --git a/tgbotapi/updates/updates-filters.html b/tgbotapi/updates/updates-filters.html index b32d58e..385f97e 100644 --- a/tgbotapi/updates/updates-filters.html +++ b/tgbotapi/updates/updates-filters.html @@ -806,7 +806,7 @@ - + \ No newline at end of file diff --git a/tgbotapi/updates/webhooks.html b/tgbotapi/updates/webhooks.html index ed1321e..309a49c 100644 --- a/tgbotapi/updates/webhooks.html +++ b/tgbotapi/updates/webhooks.html @@ -782,7 +782,7 @@ - + \ No newline at end of file