Recommend Me


Jeudi 11 juin 2009

Fin… et suite…

Voilà, le temps et venu. Je ferme définitivement ce blog pour me consacrer pleinement au suivant.

See you there.

• • •

Mardi 2 décembre 2008

Documenter avec Ruby

Classé dans : Java, Langage, Projets, Ruby — greg @ 21:00

Je viens de terminer la première partie de ce qui est certainement la plus grosse documentation que j’ai pu écrire dans ma vie. Je n’en dévoilerai pas plus sur le contenu, car il s’agit d’un travail pour mon employeur, sachez simplement qu’il s’agit d’une documentation d’API à destination de développeurs pour les technologies Windows DLL, Framework MacOSX, .Net, Java et SOAP. Ce qui m’intéresse ici est plutôt de vous parler de la méthode employée.

L’ensemble représente pour le moment 6 documents : 4 Quick Start, un document de référence technique (il en reste 3 à écrire) et un document de cas d’utilisations. Le tout représente plus de 450 pages et nous devrions dépasser les 1600 pages quand les trois derniers documents seront rédigés.

L’ensemble a été écrit en XML ce qui présente l’énorme avantage de pouvoir partager des paragraphes, voir des chapitres, entre plusieurs documents. De plus, l’écriture de cette documentation ce faisant à plusieurs, nous utilisons subversion comme repository de sources, impossible — ou tout au moins inutile — avec un document Word ou OOo. Chacun peut ainsi travailler sur une partie précise de la documentation sans perturber les autres. Nous utilisons CruiseControl.rb pour l’intégration continue.

Nous avons un ensemble de feuilles de styles permettant de générer des versions HTML (une page et multi-pages) et du PDF via FOP.

A l’origine nous utilisions ANT pour générer les documents, mais tout cela est en train de migrer vers Rake. Non seulement l’utilisation de FOPJava avec Ruby est très simple mais en plus cela nous permet de migrer tout un ensemble de scripts sous Ruby/Rake. En effet, nous avons plusieurs scripts pour nous aider. L’un par exemple utilise RubyDiff pour rechercher des différences, entre deux versions d’APIs, et génère automatiquement de nouvelles entrées dans la doc. L’utilisation de REXML nous permet de modifier de la documentation automatiquement, ou de générer de nouvelles pages à partir de templates XML, souvent avec l’aide d’Erb. Tout cela est en train d’être réuni dans un Rakefile. Bien entendu chaque action automatisée est journalisée et peut être rejouée, supprimée, remplacée… Ainsi pour la constitution de la trame du document, chacun peut savoir ce qui a été fait. Cela complété avec les possibilités offertes par SVN fait que nous pouvons à tout moment revoir l’ensemble de l’histoire de la fabrication de cette documentation. Bien entendu la conformité de l’ensemble est validée à chaque étape…

• • •

Dimanche 5 octobre 2008

API

Classé dans : Langage, Linux, People, Projets, libre — greg @ 22:12

“The userspace API you propose should however be taken out and shot, then buried with a stake through its heart, holy water in its mouth and its head cut off, at midnight in a pentacle at a crossroads in the presence of a priest”

Alan Cox (http://article.gmane.org/gmane.linux.kernel.malware/513)

• • •

Lundi 31 décembre 2007

Bonne Année

Classé dans : Famille, Friend, Important, Langage, Ruby, Tout et rien — greg @ 16:56
trails = [[0, 0]] * 60
Shoes.app do
  nostroke
  fill rgb(0×30, 0xFF, 0xFF, 0.6)

  animate(24) do
    trails.shift
    trails << self.mouse[1, 2]

    clear do
      background rgb(
        20 + (70 * (trails.last[0].to_f / self.width)).to_i,
        20 + (70 * (trails.last[1].to_f / self.height)).to_i,
        51)

      trails.each do |x, y|
        stack :top => y, :left => x do
          l = para "Bonne Année"
          f = [‘Arial 14px’, ‘Serif 34px’, ‘Monospace 18px’, ‘Arial 48px’][rand(3)]
          l.replace "Bonne Année", :font => f
        end
      end
    end
  end

end

• • •

Mercredi 25 octobre 2006

Django vs RoR vs CakePHP

Classé dans : Langage, RoR, Web — greg @ 21:08

Breek nous propose sur son blog un benchmark fonctionnel Django/Ruby on Rails/CakePHP. Le résultat donne un excellent document… dont malheureusement, comme c’est souvent le cas avec ce type de bench, on retiendra qu’il est toujours plus favorable à la technologie que l’on préfère.

• • •

Vendredi 1 septembre 2006

GNUstep et MacOSX

Classé dans : Langage, Linux, MacOSX — greg @ 8:41

Source : LinuxFR

Les frameworks Base et GUI du projet GNUstep viennent de passer respectivement en versions 1.13 et 0.11. Gorm passe en version 1.1.

Et alors ?

Et alors la grande nouveauté vient du fait qu’il est maintenant possible de lire et sauver des fichiers “nib” venant de MacOS X.

• • •

Jeudi 13 juillet 2006

Recherche avec Firefox

Classé dans : Langage, MacOSX, Objective-C, RoR, Ruby, Web — greg @ 11:22

Je viens de soumettre 2 nouveaux plugins de recherche sur Mozdev. Le premier pour rubymanual.org et le second pour railsmanual.org.

Dans ma lancée j’ai également fait un plugin pour rechercher sur le site de l’ADC sans avoir vérifié avant s’il en existait pas déjà un :/

Si vous souhaitez installer un de ces plugins, cliquez ici pour l’ADC, pour le Ruby Manual ou pour le Ruby on Rails Manual.

• • •

Jeudi 6 juillet 2006

RoR vs LAMP

Classé dans : Langage, RoR, Ruby, Web — greg @ 12:17

Nexen.net, le portail bien connu par les utilisateurs PHP/MySQL vient de mettre en ligne une actualité couétesque : “LAMP tient encore bon”.

Il semble effectivement que Ruby On Rails ait accaparé le buzz.

Ceci est loin d’être une bonne nouvelle. En effet il semble de plus en plus que le développement internet tombe sous le coup des effets de mode qui vont à l’encontre de toute logique et que parce qu’une solution émergente fait du bruit tout le monde fonde dessus parce “c’est là qu’il faut être”. Nexen nous explique que c’est un passage obligé due au fait que le projet doit “assurer une stabilité” dans sa phase de “maturité”. Mais cela sous entend également que l’on à la fâcheuse habitude de prendre ce qui est neuf et immature en laissant tomber ce qui est stable et éprouvé !

Ne me faites pas dire ce que je n’ai pas dit !

• • •

Mardi 30 mai 2006

IronRuby 0.0.1

Classé dans : .Net, Langage, Ruby — greg @ 12:55

Source : JDN|développeurs

Wilco Bauwer vient de rendre publique la première version d’IronRuby, l’implémentation de Ruby pour .NET. Cette version, 0.0.1, permet d’utiliser des objets .NET en Ruby :

reference "mscorlib"

class MyRandom < System::Random
  def Sample()
    0.5
  end
end

r = System::Random.new
r.Next(0, 100)

# import a namespace and use a generic type List<T>
include System::Collections::Generic
myList = GenericList.of(String).new
myList("Hello")

• • •

Mardi 23 mai 2006

RubyFR.org, le re-retour !

Classé dans : Langage, Ruby, Web — greg @ 18:03

Le travail sur le site RubyFR.org, consistant à récupérer les pages de l’ancien Wiki, continue. Malheureusement les problèmes de configuration persistent. Voici donc une petite liste des URLs vous permettant d’accéder aux différentes partie du site à nouveau accessibles mais pour lesquelles les liens sont faux :

Qui ? Quoi ? Comment ?
IRC
Association
Discuter
Participer
Page à idées
Projets Francophones
Trombinoscope

Groupes de travail
RDB : dédié aux bases de données
RG2 : dédié à Ruby-GNOME2
ROR : dédié à Ruby On Rails
RQT : dédié à RubyQt
RSS : dédié aux scripts systèmes

Glossaire
RubyFR
RubyGems
Ruby-GNOME2
Ruby on Rails

Notez que la doc sur les motifs de conception est en ligne et que les URLs sont correctes…

Ca se profile bien… Courage !

• • •
Page suivante »
Powered by: WordPress • Template adapted from the Simple Green' Wench theme - RSS