mciepluc / cocotb-coverage

Functional Coverage and Constrained Randomization Extensions for Cocotb
BSD 2-Clause "Simplified" License
104 stars 16 forks source link

Documentation improvements #24

Closed mciepluc closed 4 years ago

mciepluc commented 5 years ago

As this project is mainly addressed for SystemVerilog and commercial tools users to encourage them to abandon the sinking ship, it is good to provide a more informative examples and tutorials. The goal is to show consistency with SystemVerilog coverage/randomization features with much higher flexibility and user-friendliness. Also @cmarqu provided an interesting tutorial: https://www.divio.com/blog/documentation/ Please share any suggestions what should be included in the documentation. Some suggestions:

cmarqu commented 5 years ago

A table that shows the correspondence between SV and cocotb-coverage syntax would be helpful. Bonus points if it fits onto a single page to be used as a reference card (reminds me, we also need this for cocotb).

Examples... the simple packet router seems to be a default design for teaching UVM, so we can't go wrong with this. Also, Lars Asplund of VUnit has started a big undertaking of comparing VUnit to SV-UVM (in https://gitter.im/VUnit/vunit_vs_uvm) by using the tutorial at http://cluelogic.com. This page may give some more ideas.

pwiecha commented 5 years ago

Hi, as you both know I've started the yas_router some time ago but didn't have time to work on it until now. I'm planning to implement CRV at some point alongside sphinx documentation, maybe some articles about building a testbench in cocotb as well. This is my contribution proposal.

mciepluc commented 5 years ago

@pwiecha that's ok to prepare a more complex example as an external project. For a simple demo here (like already existing FIFO) I think that simple packet switch should be enough.

mciepluc commented 4 years ago

Updated documentation is committed, still a few tutorials needs to be done. I hope that this level of documentation should be sufficient for everyone.

mciepluc commented 4 years ago

Dear All, I finished writing the tutorials and the documentation is pretty much completed now. I encourage you to review it and share your comments. @cmarqu @pwiecha, other users, your comments will be very welcome! https://cocotb-coverage.readthedocs.io/en/latest/

mciepluc commented 4 years ago

documentation reviewed