User:Dereckson/Blog

From Nasqueron Agora

Some topics I could blog about. Add a new idea.

2020

December 2019 links

February links

2012 / 2014

Comments

Three level of comments

  • The header
  • The code documentation
  • The comments itself

The header

  • Project metadata
  • License

The code documentation

  • Javadoc (PHP) / XML code (.Net) formats
  • There are tools to automate the process (PHPDoc, Sandcastle, Doxygen, etc.)

The comments itself

  • Comments aren't paraphrase. You shouldn't rewrite in English what you wrote in code.
  • Explain to another people your code. Craft your comment with this explanation.

Credits

Thank you to Nojhan for the tip about explain the code to another people, and put the explanation into a comment.

Wikimedia configuration workflow

Last October, Andre Klapper became the new Bug wrangler of the Wikimedia Foundation.

He asked me to explain him our site requests configuration workflow.

In a nutshell, when a wiki wishes a configuration change, they follow this workflow:

  1. discuss the issue on the local wiki
  2. report the issue on Bugzilla (normally, they should add the 'shell' keyword as this stage, to indicate an action is required by a sysadmin with shell access)
  3. clarify the configuration change if needed
  4. the config change is then prepared, reviewed and deployed
  5. the bug is closed

Now, more often than not, a user will ask a configuration request or report a bug which is actually a config change without previous discussion. Or the issue has been discusse by 3 people on a huge wiki like en. de. fr.

In these cases, we "block" the configuration change with the shellpolicy keyword.

This is a signal to 3 users groups:

  • to the local wiki community in general, the bug requester in particular > "please launch a discussion to get a local consensus"
  • to the Wikimedia community at large (but generally there are ops people still in touch with wiki communities or stewards) > "please determine if this small discussion constitutes or not a local consensus"
  • to the tech people, "please wait before deploy"

Host a MediaWiki site: low cost solutions

  • 256 Mb VPS should be enough.
  • 128 not really (InnoDB)
  • Ideal seems to be 256 burstable to 512

Reading: #!

Sven Mascheck, The #! magic, details about the shebang/hash-bang mechanism on various Unix flavours, http://www.in-ulm.de/~mascheck/various/shebang/

https://gerrit.wikimedia.org/r/#/c/37374/1/wikibugs

Spectrum 2 on FreeBSD

A strange instruction

We can read this peculiar piece of instructions in the manual:

You should definitely have latest libpurple, so download Pidgin and compile it, because your distribution probably doesn’t have the latest one.

This is interesting. The developer mixes support instruction for its distro and build instructions!

This is plainly wrong of course. Let's compare two set of dates:

Here the update situation at the exact moment (2012-03-28) of the 2.0.0 beta 2 release:

Version bumped on the Pidgin repository | Version bumped on the FreeBSD ports repository 2.10.2 2012-03-14 2012-03-18 4 days 2.10.3 2012-03-26 2012-04-01 5 days

This is also absolutely not informative. I arbitrarily set >2.10.2 as the required version, but I have no idea of the real required version, as this is not documented.

  • Spectrum 2 is a UNIX application, not a application tailored to work only on the Linux distribution of the developer, so this is not really our problem.

https://github.com/hanzz/libtransport/blob/master/docs/guide/from_source_code.textile

Secure poll

https://bugzilla.wikimedia.org/show_bug.cgi?id=43457

MediaWiki - CSS changes

see css bug

Canfranc

Commons:Category:Estación de Canfranc

http://www.trekearth.com/gallery/Europe/Spain/Aragon/Huesca/Canfranc/photo363817.htm

http://www.coloredhome.com/paisajes_pirineo/estacion_de_canfranc/estacion_canfranc.htm

Où l'on passe la nuit avec 67 titres de rap.

Un pote caressant l'idée d'être arménien a réalisé un excellente compilation de 67 titres de rap, très majoritairement français, emplis de freestyle, de titres récents.

Car non, le rap n'est pas mort fin des années 90. Georgio, jeune rappeur parisien nous le prouve.

Je vous recommande très nettement cette compilation.

Le ghetto indé

La compilation commence fort.

En electroclash, nous avions Sexy Sushi qui s'était attaquée de façon fort réussie au mythe du ghetto indé sur son titre Rien à foutre : « C'est pas parcequ'on est underground qu'on fait des trucs mieux. ».

Voici pour ouvrir une attaque sur le sujet bienvenue dans le rap :

« Non mais parce qu'aujourd'hui le public, si tu l'écoutes tu vas pas loin hein.
Tu ferais même plutôt marche arrière. Non mais c'est vrai, il est pas clair
Il veut une chose et son contraire t'sais.
Il veut un album qui déchire mais que personne connaît
Un album pas connu mais qui déchire
Un truc introuvable mais que lui il a trouvé
Ils font tout pour t'faire connaître et une fois qu't'es connu, ils t'aiment plus. »

Passez les paroles à ceux pour qui le rap n'est pas de la musique, ils approuveront, en vous demandant de quel titre de rock avez-vous sorti cela.

Dernier MC

Kery James prépare un nouvel album pour 2013. Dans son titre Dernier MC, annonçant son prochain album, il nous livre les 7 règles pour prétendre au titre de MC.

«

  1. Tu ne dois dire que la vérité ;
  2. Fais primer la qualité sur la quantité ;
  3. Fais ton choix entre le respect et le succès ;
  4. Applique la première t'auras pas d'être vulgaire ;
  5. Ne suis jamais la mode ;
  6. Allie le fond et la forme en respectant tes propres codes ;
  7. Ne baisse jamais ton froc même si ça les choque et tu dois être le dernier MC.

»

Un jour, je dresserai un compendium des règles qui ont mon respect, et celles du hip hop seront sans doute en bonne place.

Récemment, un http://poulpy.blogspot.be/2008/12/barbare-blanc.html barbare blanc soulignait que d'aucuns contestent qu'un titre qui ne parle pas de guns, ni de bitches ni de bling puisse être considéré comme VRAI rap.

Kery James offre ici la solution pour réaliser du rap politique, au cas où Assassin ne suffisait pas comme exemple.

Et en parlant de politique, la compilation inclut Lettre à la république, qui aborde avec justesse les problèmes de la Françafrique, d'immigration et de racisme (non, ce ne sont pas des problèmes d'intégration, expression d'une hypocrisie rare que abhorre et ne compte guère employé).

En vrac

Les petites choses que j'ai particulièrement bien aimée :

  • Que Georgio nous rappelle que dans les années 2010, les Nike n'ont pas été supplantées par les Converse (« On baise même avec nos Nike, à croire que c'est toute nos vies. ») ;
  • L'allusion à l'œuvre de Tolkien dans Neshga - Calmement est sympa, « tout droit sorti d'Isengard ».

When to use Word, InDesign/Scribus, DocBook & co or LaTeX/XeTeX?

"Doing layouts in Word is like rappelling down a barbed-wire rope in a Speedo"

Custom configuration file in environment

//Loads configuration
if (isset($_SERVER) && array_key_exists('OBSIDIAN_CONFIG', $_SERVER)) {
    $configFile = $_SERVER['OBSIDIAN_CONFIG'];
    if (file_exists($configFile)) {
        include_once($configFile);
        unset($configFile);
    } else {
        die("You specified a custom configuration file path in the environment, but this file doesn't exist: $configFile");
    }
} else {
    include_once("config.php");
}