Re: Doc Git pour SPIP

Hello,

Le lun. 20 janv. 2020 à 15:50, JLuc <[email protected]> a écrit :

> Le 20/01/2020 à 13:55, Eric Lupinacci a écrit :
> > Tu sais bien car tu les as relu qu'il existe un guide Git que j'ai
> commencé et qui ne demande qu'à être complété.
> > La j'ai fait plutôt des articles type explication ou tutoriel.
>
> cf  https://blog.smellup.net/
> Effectivement je n'y pensais pas, car les actuels documents initient à
> git, mais pas à "spip avec git" ou fort peu pour
> l'instant. (Je me trompe ?)
>

Exact, c'est en fait le constat de mon apprentissage pour faire le pas vers
Git : installation, configuration, les commandes principales et leur
manipulation.
Je n'ai pu consigner que ça pour l'instant.
J'ai testé git_loader et checkout, ça fonctionne mais j'ai pas consigné.
Donc tout ce qui est du ressort de SPIP j'installe, je migre, je joue avec,
je me dépatouille quand ça merde c'est à écrire pour le dev en local.
Il faut aussi faire un digest d'utilisation de la forge.
Et aussi j'ai un chapitre sur l'utilisation d'un GUI SourceTree pour ceux
qui veulent.


>
>  > On peut ajouter une FAQ qui permet de collecter des astuces de ce genre
> et qu'on réinjectera ensuite dans des articles
>  > plus complets, la FAQ ne faisant que fournir un sommaire pointant vers
> lesdits articles.
>  > Il me semble que tu as accès, si tu ne l'as pas ou que tu veux que je
> crée la FAQ dis le moi.
> Je demandais car quand je vois passer une perle de savoir-faire, j'ai
> envie d'y avoir accés durablement et de faciliter
> cet accés à tous.  Or, habituellement je dépose et tente de structurer
> cela sur le carnet de contrib. Mais ce wiki ne
> semble pas encouragé par les core-spipeurs. Maintenant que je sais que tu
> es open pour ces perles, ça m'encourage à les
> y déposer.
>

Donc oui, on accumule sous forme de FAQ et ensuite on remet ça en forme
dans des articles thématiques plus complets en gardant la FAQ qui pointera
alors vers eux.


>
> Mais peut on dire que smellup fait partie de la doc officielle ?
> Il me semble que cette doc a sa place spip.net et programmer.spip.net vu
> comme git devient intimement lié à spip.
> Envisages tu migrer cette doc vers la galaxie ensuite ?
>
>
Oui, j'utilise la Taverne pour des raisons de simplicité (j'y fais ce que
je veux) mais tout à vocation à partir sur un site de la Galaxie.
Lequel par contre je ne sais pas trop.
Ca pourrait être contrib mais il faudrait faire le ménage dans les
rubriques que j'ai gardé pour ceux qui en ont envie ;-).
Je ne trouve pas que programmer soit le lieu pour et spip.net je ne sais
pas trop.
Mais là on va partir sur la discussion éternelle de l'organisation de la
doc spip.



> Alors les questions ensuite.
>
> À mon avis à la doc existante, il faut maintenant ajouter des informations
> pour utiliser git-pour-SPIP spécifiquement et
> très en pratique.
>
> Pour que tu te rendes un peu compte de ce qui selon moi doit encore être
> documenté, voici des questions pratiques qui me
> viennent à l'esprit.
> Leur réponse utilisera *in spipu* les concepts généraux que tu as déjà
> présenté.
> Je peux répondre à quelques unes de ces questions et les documenter, mais
> pas toutes (ou alors il me faudrait beaucoup
> expérimenter avant de conclure, tout en restant dans le doute car
> certaines réponses dépendent d'une d'une culture
> collective dont je n'ai pas toutes les clés).
>

Alors pour te dire tout ce que j'ai écrit je l'ai testé en local avec mon
mac et un PC (désolé j'ai pas d'*NIX).
Je pense que c'est essentiel pour ne pas raconter des conneries et fournir
les logs cli corrects.

Tu es admin restreint de la rubrique sur la Taverne.
Initie un article ou tu fous tout ce qui te passe par la tête et entre les
mains.
On classera et on répartira ça dans des articles ensuite.
Tu peux aussi alimenter la FAQ si les Q/R sont simples.

++
Eric