README: tone down the instability warning to reflect current status.
authorwhitequark <cz@m-labs.hk>
Fri, 28 Jun 2019 05:10:29 +0000 (05:10 +0000)
committerwhitequark <cz@m-labs.hk>
Fri, 28 Jun 2019 05:10:29 +0000 (05:10 +0000)
README.md

index c50971ba9d36791ea49647d54708c8d265e83de2..83766254272527d3eb09879750ab7f17ef9af86d 100644 (file)
--- a/README.md
+++ b/README.md
@@ -2,7 +2,7 @@
 
 ## A refreshed Python toolbox for building complex digital hardware
 
-**nMigen is incomplete and undergoes rapid development. The nMigen documentation refers to features that may not be implemented yet and compatibility guarantees that may not hold yet. Use at your own risk.**
+**Although nMigen is incomplete and in active development, it can already be used for real-world designs. The nMigen language (`nmigen.ast`, `nmigen.dsl`) will not undergo incompatible changes. The nMigen standard library (`nmigen.lib`) and build system (`nmigen.build`) will undergo minimal changes before their design is finalized.**
 
 Despite being faster than schematics entry, hardware design with Verilog and VHDL remains tedious and inefficient for several reasons. The event-driven model introduces issues and manual coding that are unnecessary for synchronous circuits, which represent the lion's share of today's logic designs. Counterintuitive arithmetic rules result in steeper learning curves and provide a fertile ground for subtle bugs in designs. Finally, support for procedural generation of logic (metaprogramming) through "generate" statements is very limited and restricts the ways code can be made generic, reused and organized.