Un site web pour explorer / aider à comprendre le code source de logiciels open source

Bonjour,

Je travaille sur un site web présentant le code source de logiciels open source:
kezacode.fr

C'est un projet personnel et je profite de ce forum pour le faire connaitre, et avoir vos retours si vous trouvez cela intéressant.
Pour l'instant, on y trouve les logiciels open source : firefox, chromium, libre office, vlc media player, linux kernel.
Et pour chacun (variable)
- une documentation rapide
- un explorateur de fichiers enrichi qui permet d'avoir le descriptif des répertoires, de voir les composants à l'intérieur des fichiers projet, le contenu de certains fichiers source...
- la liste des composants générés
- une revue des domaines couverts par le code (ex: multimedia, réseau, sécurité)

N'hésitez pas à rebondir si vous trouvez cela intéressant... (j'ai très peu de temps à consacrer à ce projet, donc est-ce que cela a un intérêt de continuer?)
Quelques améliorations en préparation (lente): un explorateur graphique des composants et leurs dépendances, l'ajout du code d'Android, ....

A voir aussi comment mieux faire connaitre ce travail (là je tente le forum developpez.net, ça semble un bon endroit ?)

Bonjour,

J'ai cliqué sur Firefox (depuis la page principale), j'ai une erreur 404. (page en question : https://www.kezacode.fr/firefox/fr/t...f_content.html )
Une autre 404 : https://www.kezacode.fr/chromium/fr/...ure_Intro.html
Je pense que l'idée est intéressante, par contre, je serai plus tentée de dire que ce genre de documentation trouveraient peut être une place au sein même du projet qu'elle documente. Bref, faire des contributions au projet open source en question afin d'améliorer leur documentation.

L'explorateur de fichiers manque d'un filtre. L'élément All Files m'embête, car cela m'oblige à faire un clic en plus pour voir le contenu d'un dossier.

Et pour répondre à la question de est-ce que ça vaut le coup de continuer le site : si vous n'avez pas le temps, améliorer l'explorateur de fichiers n'en vaut pas le jeu. Il serait meilleur de consacrer ce temps à aider la communauté, les projets en question, en améliorant leur documentation ou encore, en aidant les nouveaux contributeurs.
Si vous avez fait ce site pour apprendre le développement Web, c'est très bien et continuez à vous éclater ;) . Je trouve l'idée plutôt bonne/intéressante.

Merci pour ce retour et d'avoir pris le temps de jeter un coup d'oeil! :)

Pour la partie facile: j'ai corrigé les 2 liens.

Je note que l'intérêt est discutable en l'état, hum...

Je précise que mon objectif n'est pas de contribuer spécifiquement à la documentation de logiciels open source précis, plutôt de trouver des moyens génériques de comprendre différents codes source / projets: en plus d'une documentation manuelle, cela implique d'extraire automatiquement certaines informations (par ex : composants générés par les projets BUILD), et de proposer des outils pour une "exploration enrichie" du code (comme l'explorateur avec les répertoires commentés, le contenu de certains fichiers...)

Je sortirai probablement les quelques fonctionnalités que j'ai encore en stock et qui sont quasi-développées (explorateur graphique du graphe des composants)... A voir pour la suite.
Je note aussi les suggestions sur l'explorateur.

Je continue à enrichir kezacode en ajoutant de nouveaux outils, par exemple avec des graphiques interactifs (des composants et leurs dépendances, des domaines thématiques...).
Suivez https://www.kezacode.fr si vous voulez jeter un coup d'oeil...

Après un bref coup d’œil, je trouve que c'est bien plus intéressant que la dernière fois :ccool:. Il faut que je regarde un peu plus en profondeur du coup :)

Salut,

LittleWhite, le projet aura une meilleure visibilité dans Outils pour le C et le C++.

kezacode, tu as fait un travail à la fois remarquable et appréciable, ça me semble très prometteur, je te dis bravo.

Merci LittleWhite et kaitlyn:)

ça va m'encourager à continuer à enrichir le contenu et le concept.
Les choses avancent hyper lentement (boulot prenant), mais je pense qu'il y a beaucoup de choses à creuser...

"Côté visible", en dehors de mises à jour des projets déjà en ligne et améliorations incrémentales, j'ajouterai probablement Android Open Source Project dans les mois à venir.

Si vous avez un projet open source qu'il serait particulièrement intéressant d'ajouter, n'hésitez pas à suggérer (en sachant que ça pourrait me prendre un temps fou à le traiter, ça dépendra de son contenu et les améliorations nécessaires côté backend...).

Salut,

Oui, moi je verrais bien Thunderbird dans la liste, ce qui permettra entre autres de comparer et faire un parallèle avec Firefox (ESR).

Hello Kaitlin,

Thunderbird: c'est fait 8-)... à améliorer, mais c'est le premier jet.

Lien vers Kezacode / doc thunderbird

Super ! Bravo !
Dans la foulée j'ajoute un autre projet potentiellement intéressant, il s'agit de Code::Blocks

Bonjour,

Nouvel ajout sur kezacode: Android Open Source Project.

Il est donc possible de:
- parcourir le code avec un explorateur qui commente ce que contiennent les répertoires, qui permet de visualiser les composants générés par les projets, les classes/fonctions des fichiers C / C++ / Java.
- de voir graphiquement les composants et leurs interdépendances.
- de parcourir les interfaces exposées (AIDL, HAL notamment pour Android)
- d'avoir un peu de documentation ("manuelle"), qui renvoie vers la documentation Android pour plus de détails, car ce n'est pas le but de ce projet de ré-écrire une documentation à la main...
- etc.

Android était un gros morceau à digérer, le défi étant de ne pas faire exploser mon outil d'analyse et de pouvoir reprendre une analyse non terminée (>24h ...).

@Kaitlin, j'ai ajouté Code::Blocks à ma wishlist. Cela risque de trainer car j'ai beaucoup de choses dans celle-ci, je vise le S1 2023 !
En priorité, je vais supporter le parsing de code source Python et Rust pour la prochaine mise à jour de la documentation de Firefox. Je souhaite aussi me tourner vers le deep learning / NLP ...

Si vous trouvez kezacode intéressant, n'hésitez pas à faire connaitre!
S'il y a des améliorations qui feraient une grosse différence ( qui semblent faisables et en phase avec le concept de kezacode ), n'hésitez pas à m'en faire part. Mais pour le dire tout de suite, je ne serai pas forcément en mesure de le développer, car j'ai en fait peu de temps pour ce projet, je dois très fortement limiter mes ambitions...