Git and Hiki

Hi all

The hiki [http://ruby-gnome2.sourceforge.jp/] still have link to the
subversion repository and not the git one.
I was not able to change this link in the left part of the hiki pages.
Can someone change this ? It would be helpful.

Indeed, our documentation pages on hiki seem to be in a very bad shape.
Editing and/or updating pages seldom works as expected. Recently the
entire site became inaccessible. Sending e-mail to maintenance about
problems is in vain.

Is anybody aware of these problems?

Hi,

In [email protected]
“[ruby-gnome2-devel-en] Git and Hiki” on Sun, 15 Jan 2012 17:09:12
+0100,
Vincent C. [email protected] wrote:

The hiki [http://ruby-gnome2.sourceforge.jp/] still have link to the
subversion repository and not the git one.
I was not able to change this link in the left part of the hiki pages.
Can someone change this ? It would be helpful.

Thanks. I’ve fixed it.

We want to migrate Hiki to YARD but nobody isn’t woking on
it. :<

Thanks,

kou

Hi,

In [email protected]
“Re: [ruby-gnome2-devel-en] Git and Hiki” on Mon, 16 Jan 2012 13:06:54
+0100,
Leszek Z. [email protected] wrote:

Then I will take a look at it. But it will be end of weekend.

Thanks!
Here are some pointers:

  • raw Hiki data: GitHub - ruby-gnome/doc: Documentation
    (But they aren’t the latest data. We should pull the
    latest data from ruby-gnome2.sourceforge.jp at migration
    time.)

    • hiki/cgi-bin/hiki_writer.rb is a script that generates
      static HTMLs from raw Hiki data. It’s created to be a
      workaround for too slow our Hiki but it’s not used
      yet. Because we applied another speed improvement
      changes. (The old our Hiki is more slower than the
      current our Hiki.)
  • A discusstion about migrating to YARD from Hiki:
    Migrate the documentation from Hiki to YARD - Ruby-Gnome 2 - Ruby-Forum

Thanks,

kou

Then I will take a look at it. But it will be end of weekend.

2012/1/16 Kouhei S. [email protected]

Then I will take a look at it. But it will be end of weekend.

Very nice!

Please keep in mind though that, although the current Hiki is not
perfect, the documentation it contains is very very helpful. Let’s try
to keep that usability and helpfulness.

The Wiki was the reason I started with ruby-gtk. Ruby-qt does not have
any wiki at all for instance. :slight_smile:

Like many other open source projects, what is a bit painful.

Also a section on GitHub with informations about how to contribute would
be
a good step forward, i.e.
what libs with versions are needed for development/bugfixing?
what are code standards that would be good to stay with?
etc.

2012/1/21 Marc H. [email protected]

Le 16 janvier 2012 13:00, Kouhei S. [email protected] a crit :

Thanks. I’ve fixed it.

Thanks!