namespace tf {

/** @page release-3-0-0 Release 3.0.0 (2021/01/01)

%Taskflow 3.0.0 is the 1st release in the 3.x line! 
This release includes several new changes such as CPU-GPU tasking, algorithm collection,
enhanced web-based profiler, documentation, and unit tests.

@attention
Starting from v3, we have migrated the codebase to the @CPP17 standard
to largely improve the expressivity and efficiency of the codebase.

@tableofcontents

@section release-3-0-0_download Download

%Taskflow 3.0.0 can be downloaded from <a href="https://github.com/taskflow/taskflow/releases/tag/v3.0.0">here</a>.

@section release-3-0-0_system_requirements System Requirements

To use %Taskflow v3.0.0, you need a compiler that supports C++17:

@li GNU C++ Compiler at least v7.0 with -std=c++17
@li Clang C++ Compiler at least v6.0 with -std=c++17
@li Microsoft Visual Studio at least v19.27 with /std:c++17
@li AppleClang Xcode Version at least v12.0 with -std=c++17
@li Nvidia CUDA Toolkit and Compiler (nvcc) at least v11.1 with -std=c++17
@li Intel C++ Compiler at least v19.0.1 with -std=c++17

%Taskflow works on Linux, Windows, and Mac OS X.

@section release-3-0-0_working_items Working Items

@li enhancing the taskflow profiler (<a href="https://github.com/taskflow/tfprof">TFProf</a>)
@li adding methods for updating tf::cudaFlow (with unit tests)
@li adding support for @cuBLAS
@li adding support for @cuDNN
@li adding support for SYCL (ComputeCpp and DPC++)

@section release-3-0-0_new_features New Features

@subsection release-3-0-0_taskflow_core Taskflow Core

@li replaced all non-standard libraries with C++17 STL (e.g., @std_optional, @std_variant)
@li added tf::WorkerView for users to observe the running works of tasks
@li added asynchronous tasking (see @ref AsyncTasking)
@li modified tf::ObserverInterface::on_entry and tf::ObserverInterface::on_exit to take tf::WorkerView
@li added a custom graph interface to support dynamic polymorphism for tf::cudaGraph
@li supported separate compilations between %Taskflow and CUDA (see @ref CompileTaskflowWithCUDA)
@li added tf::Semaphore and tf::CriticalSection to limit the maximum concurrency
@li added tf::Future to support cancellation of submitted tasks (see @ref RequestCancellation)

@subsection release-3-0-0_cudaflow cudaFlow

@li added tf::cudaFlowCapturer for building a %cudaFlow through stream capture (see @ref GPUTaskingcudaFlowCapturer)
@li added tf::cudaFlowCapturerBase for creating custom capturers
@li added tf::cudaFlow::capture for capturing a %cudaFlow within a parent %cudaFlow
@li added tf::Taskflow::emplace_on to place a %cudaFlow on a GPU
@li added tf::cudaFlow::dump and tf::cudaFlowCapturer::dump to visualize %cudaFlow
@li added tf::cudaFlow::offload and update methods to run and update a %cudaFlow explicitly
@li supported standalone %cudaFlow 
@li supported standalone %cudaFlowCapturer 
@li added tf::cublasFlowCapturer to support @cuBLAS (see LinearAlgebracublasFlowCapturer)

@subsection release-3-0-0_utilities Utilities

@li added utility functions to grab the cuda device properties (see cuda_device.hpp)
@li added utility functions to control cuda memory (see cuda_memory.hpp)
@li added utility functions for common mathematics operations
@li added serializer and deserializer libraries to support tfprof
@li added per-thread pool for CUDA streams to improve performance

@subsection release-3-0-0_profiler Taskflow Profiler (TFProf)

@li added visualization for asynchronous tasks
@li added server-based profiler to support large profiling data (see @ref Profiler)

@section release-3-0-0_new_algorithms New Algorithms

@subsection release-3-0-0_cpu_algorithms CPU Algorithms

@li added parallel sort (see @ref ParallelSort) 

@subsection release-3-0-0_gpu_algorithms GPU Algorithms

@li added single task (see @ref SingleTaskCUDA)
@li added parallel iterations (see @ref ForEachCUDA)
@li added parallel transforms 
@li added parallel reduction


@section release-3-0-0_bug_fixes Bug Fixes 

@li fixed the bug in stream capturing (need to use @c ThreadLocal mode)
@li fixed the bug in reporting wrong worker ids when compiling 
    a shared library due to the use of @c thread_local (now with C++17 
    @c inline variable)

@section release-3-0-0_breaking_changes Breaking Changes

@li changed the returned values of asynchronous tasks to be @std_optional in order
to support cancellation (see @ref AsyncTasking and @ref RequestCancellation)

@section release-3-0-0_deprecated_items Deprecated and Removed Items 

@li removed tf::cudaFlow::device; users may call tf::Taskflow::emplace_on to associate a cudaflow with a GPU device
@li removed tf::cudaFlow::join, use tf::cudaFlow::offload instead
@li removed the legacy tf::Framework
@li removed external mutable use of tf::TaskView

@section release-3-0-0_documentation Documentation

@li added @ref CompileTaskflowWithCUDA
@li added @ref BenchmarkTaskflow
@li added @ref LimitTheMaximumConcurrency
@li added @ref AsyncTasking 
@li added @ref GPUTaskingcudaFlowCapturer
@li added @ref RequestCancellation
@li added @ref Profiler
@li added @ref cudaFlowAlgorithms
  + @ref SingleTaskCUDA to run a kernel function in just a single thread
  + @ref ForEachCUDA to perform parallel iterations over a range of items
  + @ref ParallelTransformsCUDA to perform parallel transforms over a range of items
@li added @ref Governance
  + @ref rules
  + @ref team
  + @ref codeofconduct
@li added @ref Contributing
  + @ref guidelines
  + @ref contributors
@li revised @ref ConditionalTasking
@li revised documentation pages for files

@section release-3-0-0_miscellaneous_items Miscellaneous Items

We have presented %Taskflow in the following C++ venues with recorded videos:
  + @CppCon20Talk
  + @MUCpp20Talk

We have published %Taskflow in the following conferences and journals:
  + Tsung-Wei Huang, &quot;[A General-purpose Parallel and Heterogeneous Task Programming System for VLSI CAD](iccad20.pdf),&quot; <i>IEEE/ACM International Conference on Computer-aided Design (ICCAD)</i>, CA, 2020
  + Chun-Xun Lin, Tsung-Wei Huang, and Martin Wong, &quot;[An Efficient Work-Stealing Scheduler for Task Dependency Graph](icpads20.pdf),&quot; <i>IEEE International Conference on Parallel and Distributed Systems (ICPADS)</i>, Hong Kong, 2020
  + Tsung-Wei Huang, Dian-Lun Lin, Yibo Lin, and Chun-Xun Lin, &quot;Cpp-Taskflow: A General-purpose Parallel %Task Programming System at Scale,&quot;	<em>IEEE Transactions on Computer-aided Design of Integrated Circuits and Systems (TCAD)</em>, to appear, 2020

*/

}
