[FEATURE RELEASE] - See release notes on GitHub for a list of changes on v0.1.1.0

Author: TavariAgent

SETUP.md DOCS/SETUP.mdSETUP.md renamed to DOCS/SETUP.md

@@ -1,74 +1,86 @@
 # TokenGate Concept
-  
+
 *"Threading and Async Token Concurrency"* is a concept that  
 positions itself in the intersection of threading and asynchronous  
 programming.  
 
+**Jump to:** [Introduction](#introduction) · [Concept Overview](#concept-overview) · [Conclusion](#conclusion)
+
 ---
 
 ## Introduction
 
-In the realm of programming, threading and asynchronous compute   
-are two powerful concepts that enable developers to create efficient  
-and responsive applications.  
-  
-"Threading" refers to a program which completes multiple   
-threads of execution concurrently.
-  
-On the other hand, "Async" is a programming architecture that allows   
-developers to write code that can handle multiple tasks simultaneously   
-on the main thread.
+In the realm of programming, threading and asynchronous compute  
+are two powerful concepts that enable developers to create efficient    
+and responsive applications.    
+
+"Threading" refers to a program which completes multiple    
+threads of execution concurrently.  
+
+On the other hand, "Async" is a programming architecture that allows  
+developers to write code that can handle multiple tasks simultaneously  
+on the main thread.  
+
+[↑ Top](#tokengate-concept)
 
 ---
-  
-## Concept Overview  
-  
-Threading and asynchronous compute are techniques that promote   
+
+## Concept Overview
+ 
+Threading and asynchronous compute are techniques that promote  
 parallelism in execution of tasks, but they differ in their approach.  
-Threading involves creating multiple worker threads of execution within a   
-single process, while async is about non-blocking orchestration.
-  
-The concept comes together when you apply tokenization logic to manage   
-concurrent tasks. Tokens can be used to represent individual tasks or   
+Threading involves creating multiple worker threads of execution within a  
+single process, while async is about non-blocking orchestration.  
+
+The concept comes together when you apply tokenization logic to manage  
+concurrent tasks. Tokens can be used to represent individual tasks or  
 operations, allowing for better control and coordination of concurrent  
-processes.
+processes.  
 
 Structurally tokens open a window of possibility for performing tasks  
-in a way that respects both async and threading paradigms, allowing for   
-a more flexible and efficient approach to concurrency. By leveraging   
-tokens, developers can create systems that are both responsive and   
-capable of handling a high volume of tasks without blocking the main   
+in a way that respects both async and threading paradigms, allowing for  
+a more flexible and efficient approach to concurrency. By leveraging  
+tokens, developers can create systems that are both responsive and  
+capable of handling a high volume of tasks without blocking the main  
 thread or overwhelming system resources.  
-  
+ 
 The architecture takes form over "worker mailboxes" and an "async event  
 loop" that manages the execution of tasks. If workers are given positions  
-to monitor a mailbox with an index, tokens can be managed through   
-execution via async distribution and threaded task consumption.
+to monitor a mailbox with an index, tokens can be managed through  
+execution via async distribution and threaded task consumption.  
+
+In practice putting Async and Threading together directly is functionally  
+intricate, but by using tokens to manage the execution of tasks it's possible.  
 
-In practice putting Async and Threading together directly is functionally   
-intricate, but by using tokens to manage the execution of tasks it's possible. 
+[↑ Top](#tokengate-concept)
 
 ---
 
 ## Conclusion
-In conclusion, threading and asynchronous concurrency are powerful   
+
+In conclusion, threading and asynchronous concurrency are powerful  
 concepts that can be effectively combined using tokens.  
 
-This concept is not simply about mixing threading and async. It is about   
-using tokens to bridge the strengths of both, allowing asynchronous    
-orchestration and structured threaded execution to work together in   
-one indexed system.   
+This concept is not simply about mixing threading and async. It is about  
+using tokens to bridge the strengths of both, allowing asynchronous  
+orchestration and structured threaded execution to work together in  
+one indexed system.  
+
+When worker positioning and token flow are preserved correctly,  
+the result is a new approach that doesn't fight the architectural  
+strengths of either paradigm, but instead leverages them to create  
+a more efficient and responsive system.  
+
+To get deeper insight explore the following resources:  
 
-When worker positioning and token flow are preserved correctly,   
-the result is a new approach that doesn't fight the architectural   
-strengths of either paradigm, but instead leverages them to create   
-a more efficient and responsive system.
+- [Concurrency in Python](https://realpython.com/python-concurrency/)
+- [Asyncio in Python](https://realpython.com/async-io-python/)
+- [Python's Asyncio Library](https://docs.python.org/library/asyncio.html)
+- [Python's Threading Library](https://docs.python.org/library/threading.html)
 
+For usage examples and setup see:
 
-To get deeper insight explore the following resources:
-- "Concurrency in Python": https://realpython.com/python-concurrency/
-- "Asyncio in Python": https://realpython.com/async-io-python/
-- "Python's Asyncio Library": https://docs.python.org/library/asyncio.html
-- "Python's Threading Library": https://docs.python.org/library/threading.html  
+- [proof-of-concept.md](proof-of-concept.md) — full architecture walkthrough with benchmarks  
+- [quick-proof.md](quick-proof.md) — focused proof of CPU, I/O, and mixed workloads  
 
-For usage examples and install see: (proof-of-concept.md or quick-proof.md)
+[↑ Top](#tokengate-concept)