Skip to content

PLAN 1.1

Jump to bottom
Brian Lehnen edited this page Apr 8, 2026 · 1 revision

phase: 02-core-usage plan: "1.1" wave: 1 dependencies: [] must_haves:

  • _Sidebar.md renames ProducerLinq to ProducerMethod, ConsumerLinq to ConsumerMethod, ConsumerLinqAsync to ConsumerMethodAsync
  • Home.md states .NET 10.0 / .NET 8.0 as supported targets with no net48/netstandard2.0 references
  • Home.md references cron expressions instead of Schyntax for job scheduler feature
  • Usage.md renames all Linq links to Method equivalents and adds missing queue variants files_touched:
  • _Sidebar.md
  • Home.md
  • Usage.md tdd: false

Plan 1.1 -- Navigation and Entry Pages

Wave 1 -- Foundation. No dependencies. Must complete before Waves 2 and 3 since all other pages are reached through sidebar and usage links.

Task 1: Update _Sidebar.md with Linq-to-Method renames

In `_Sidebar.md`, make these exact replacements:

  1. Line 4: Change link text and URL from ProducerLinq to ProducerMethod:

    • [ProducerLinq](https://github.com/blehnen/DotNetWorkQueue/wiki/ProducerLinq)
    • becomes [ProducerMethod](https://github.com/blehnen/DotNetWorkQueue/wiki/ProducerMethod)

  2. Line 7: Change link text and URL from ConsumerLinq to ConsumerMethod:

    • [ConsumerLinq](https://github.com/blehnen/DotNetWorkQueue/wiki/ConsumerLinq)
    • becomes [ConsumerMethod](https://github.com/blehnen/DotNetWorkQueue/wiki/ConsumerMethod)

  3. Line 10: Change link text and URL from ConsumerLinqAsync to ConsumerMethodAsync:

    • [ConsumerLinqAsync](https://github.com/blehnen/DotNetWorkQueue/wiki/ConsumerLinqAsync)
    • becomes [ConsumerMethodAsync](https://github.com/blehnen/DotNetWorkQueue/wiki/ConsumerMethodAsync)

No other sidebar changes in this plan. Typo fixes ("Additonal", "Posion") are deferred to Phase 5 consistency pass since those entries relate to pages not touched in Phase 2.

grep -c "ProducerMethod|ConsumerMethod\b|ConsumerMethodAsync" /mnt/f/git/dotnetworkqueue.wiki/_Sidebar.md Output is 3. No lines in _Sidebar.md contain "ProducerLinq", "ConsumerLinq", or "ConsumerLinqAsync".

Task 2: Update Home.md framework targets and feature list

In `Home.md`, make the following changes:

  1. Job scheduler feature (line 27): Replace the Schyntax reference. Change: 10) Job scheduler - schedule recurring work with [Schyntax](https://github.com/schyntax/schyntax) expressions. Multiple schedulers can run for redundancy. See [Scheduler](https://github.com/blehnen/DotNetWorkQueue/wiki/Scheduler). to: 10) Job scheduler - schedule recurring work with cron expressions via the [Cronos](https://github.com/HangfireIO/Cronos) library. Multiple schedulers can run for redundancy. See [Scheduler](https://github.com/blehnen/DotNetWorkQueue/wiki/Scheduler).

  2. Add framework targets paragraph after the introduction paragraph (after line 2, before "A redis transport...") to state supported targets: Insert: The library targets .NET 10.0 and .NET 8.0.

No other changes to Home.md. The page already has the correct feature list from the prior Phase 1 update.

Do NOT touch: License section, feature items 1-9 or 11-13 (these are already correct).

grep -i "net48|netstandard2.0|.NET Framework 4.8|.NET Standard 2.0|Schyntax" /mnt/f/git/dotnetworkqueue.wiki/Home.md; echo "exit: $?" grep returns no matches (exit code 1). Home.md contains "net10.0" or ".NET 10.0" and ".NET 8.0" references. Schyntax is no longer mentioned.

Task 3: Update Usage.md with renamed links and missing queue variants

Replace the entire content of `Usage.md` with the updated queue variant list. The current page has 8 entries; the updated version must cover all public `QueueContainer.Create*` consumer/producer methods.

New content for Usage.md:

#### Usage

The following queues are available

**Producers**

* [Producer](https://github.com/blehnen/DotNetWorkQueue/wiki/Producer) -- Send typed messages to a queue
* [ProducerMethod](https://github.com/blehnen/DotNetWorkQueue/wiki/ProducerMethod) -- Send lambda expressions to a queue for remote execution

**Consumers**

* [Consumer](https://github.com/blehnen/DotNetWorkQueue/wiki/Consumer) -- Process messages using dedicated worker threads
* [ConsumerAsync](https://github.com/blehnen/DotNetWorkQueue/wiki/ConsumerAsync) -- Process messages using a shared thread pool via the task scheduler
* [ConsumerMethod](https://github.com/blehnen/DotNetWorkQueue/wiki/ConsumerMethod) -- Process lambda expressions using dedicated worker threads
* [ConsumerMethodAsync](https://github.com/blehnen/DotNetWorkQueue/wiki/ConsumerMethodAsync) -- Process lambda expressions using a shared thread pool via the task scheduler

**Advanced**

* [ConsumerAsyncWorkGroup](https://github.com/blehnen/DotNetWorkQueue/wiki/ConsumerAsyncWorkGroup) -- Limit thread usage per queue within the task scheduler
* [Scheduler](https://github.com/blehnen/DotNetWorkQueue/wiki/Scheduler) -- Schedule recurring jobs using cron expressions

Key changes from current:

  • ProducerLinq renamed to ProducerMethod
  • ConsumerLinq renamed to ConsumerMethod
  • ConsumerLinqAsync renamed to ConsumerMethodAsync
  • Descriptions updated to say "lambda expressions" instead of "Linq expression"
  • Scheduler description changed from "Schyntax expressions" to "cron expressions"
  • Organized into Producers / Consumers / Advanced sections for clarity
  • Descriptions tightened to explain the key difference (dedicated threads vs shared pool, typed messages vs lambda expressions)
grep -c "Linq\|Schyntax" /mnt/f/git/dotnetworkqueue.wiki/Usage.md; echo "exit: $?" grep returns 0 matches. Usage.md contains links to ProducerMethod, ConsumerMethod, and ConsumerMethodAsync. Scheduler entry says "cron expressions".

For any issues please use the GitHub issues

  1. Introduction
  2. Usage
  3. Logging
  4. Admin
  5. Metrics
  6. Trace
  7. Monitoring
  8. Message Interception
  9. Dashboard
  10. Maintenance Mode
  11. Message History
  12. Transports
  13. Job Scheduler
  14. Migration Guide

Clone this wiki locally