[myhdl-list] Documentation doubts

[Jan D. <ja...@ja...>]

Hi all:

I am currently updating the documentation for release 0.5.
With the 0.5 release, I hope to attract new users.

However, I'm not sure the current set of docs is adequate
for new users. Pointing to the whatsnew document and the
manual may be overwhelming.

I'm not asking for addition work :-) but shouldn't there
be some kind of Getting Started document? E.g. taking
a simple example all the way to Verilog.

Or would it be sufficient to rewrite the first chapter
of the manual, e.g. by moving the stuff about bus-functional
procedures to a later chapter, and making it more tutorial-
like?

As you have all been new users at one point, perhaps you
have some ideas on what was missing (if anything) to get
you on track asap.

Regards,

Jan

-- 
Jan Decaluwe - Resources bvba - http://www.jandecaluwe.com
Losbergenlaan 16, B-3010 Leuven, Belgium
     From Python to silicon:
     http://myhdl.jandecaluwe.com