Re: [myhdl-list] myhdl.org website migration

[Christopher F. <chr...@gm...>]

<snip>
>
> http://new.myhdl.org/
>
> Site development and deployment happens in a
> natural way from mercurial repositories on bitbucket.
>
> Of course, I don't want to force noone to move to
> the new system. However, all those that have
> made significant contributions in the past may
> email me privately if they would like to become
> a contributor to the new websites.

Couple (minor) comments on the new site.

Is there a way to easily link back to the site from
the manual?  I found it a little frustrating jumping
to the manual and back to the site.

I realize the menu system has the links to get started,
etc.  But I think having some more content on the landing
page would be beneficial for new visitors, etc.  I can
create a pull-request with some ideas.

Also, my contribution plan to the new site is adding
examples.  In the past I experimented with adding the
examples to the manual and using doctest to verify the
examples when a new version of the manual was created.
I think this would be good as release tests (that is
verifying the examples on the site still work).  Now,
that the new website is in a repository, I propose we
add a little (as little as possible) formality to the
examples so we can leverage this code collection for
release testing, e.g. all examples should have:

     1. description write up
     2. .py file with working example
     3. test for the example

In addition, there are ways to embedded the code from
bitbucket in the example write-up, the write-up can
always have the latest code (easy to maintain the examples),
thoughts?

Regard,
Chris