Re: Doc Git pour SPIP

Le ven. 24 janv. 2020 10:46, JLuc a écrit :

> Le 21/01/2020 à 09:40, Gildas Cotomale a écrit :
> > Les forges ont une fonctionnalité de recherche...
>
> Recherche d'une organisation, d'un utilisateur ou d'un dépot selon
> l'onglet où on se trouve,
> mais pas de recherche du source.
>

Si si (je réponds en retard, et j'ai vu que quelqu'un d'autre a mentionné
le fait que Gitea n'active pas cette fonctionnalité par défaut car
l'indexation a son coût)
Après, pour les autres forges, la recherche dans le code est limité au
dépôt (utile pour retrouver une fonction/variable/constante dans plusieurs
fichiers en mode Internet et non local) ce qui ne correspond pas à ton
besoin (si j'ai bien compris)
Il y a aussi, dans d'autres forges, la recherche par nom de fichier sur
l'ensemble d'une organisation (ou d'un auteur) je crois.


> > Sinon ça milite pour généraliser l'autodoc...
>
> C'est bien utile en effet,
> mais ça peut juste remplacer quelques cas d'usage d'une recherche locale
> sur la zone.
>

Ça donne les fichiers qui utilisent la référence si on a configuré cela
pour... (et il faut que tout soit vu comme un seul ensemble)
À minima on a juste les signatures (i.e. classses/méthodes/paramètres) par
projet, sans devoir aller fouiller le code. C'est utile si c'est juste pour
savoir rapidement comment utiliser  un bout de tuyauterie


> JL
>
> >
> > Le mar. 21 janv. 2020 09:31, JLuc a écrit :
> >
> >     Le 20/01/2020 à 16:36, cam.lafit <[email protected]> a écrit :
> >      > Je réagis sur un point :
> >     merci
> >      >> - Est-ce une bonne pratique de récupérer le code de tous les
> plugins de la zone comme avec svn ?
> >      >
> >      > Cela n'a JAMAIS été une bonne pratique avec svn. On a toujours
> dit :
> >      > "Merci de faire des checkout sur uniquement les plugins qui vous
> >      > intéressent et non sur la racine de la zone."
> >
> >     Pas conseillé mais assez souvent utile :
> >     Pour comprendre l'usage d'un pipeline ou d'une fonction, rien de tel
> qu'une recherche globale sur la zone pour étudier
> >     le code qui l'utilise.
> >
> >     Et parfois nécessaire :
> >     des fonctions de nospam ont récemment été préfixées par nospam_
> >     Pas plus tard qu'hier, la recherche sur le source de toute la zone
> m'a permis de trouver
> >     les ocurences de ces fonctions et de corriger le plugin qui restait
> à corriger.
> >     Quelle alternative sans tout avoir sur place ?
> >
> >     JL
> >
> >
>