[hgbook ver. 2015] Updated version of the Mercurial book on foss.heptapod.net

[PIERRE AUGIER]

----- Mail original -----
> De: "Pierre-Yves David" <pierre-yves.david at ens-lyon.org>
> À: "PIERRE AUGIER" <pierre.augier at univ-grenoble-alpes.fr>, "mercurial" <mercurial at lists.mercurial-scm.org>
> Envoyé: Mardi 21 Février 2023 17:59:57
> Objet: Re: [hgbook ver. 2015] Updated version of the Mercurial book

> On 2/21/23 17:05, PIERRE AUGIER wrote:
>> As already said, I worked on a new version of the Mercurial book. It is now in a
>> better shape!
>>
>> For now, the repository is hosted on Github
>> https://github.com/paugier/mercurial-jupyterbook. Of course it would make more
>> sense to have this project hosted on foss.heptapod.
> 
> 
> That would be great to have this on foss. I think you already have the
> necessary right to import it ;-)

Great! The project is now on foss.heptapod.net: 

https://foss.heptapod.net/mercurial/mercurial-jupyterbook

It means that the members of the Mercurial group on foss.heptapod can already push topics on this repo. For other people, do not hesitate to ask to get the developer rights on the project.

> 
>> The build system is completely different (no more separated .rst + .t files nor
>> complicated Makefiles). The sources are IMHO much cleaner and the result is a
>> bit prettier.
> 
> I see you used jupyter notebooks. Which kind of "kernel" did you use ?
> 

I use the Bash kernel to be able to run the examples of the 2015 version of the book.

I added some texts in the README to explain a bit how its works and how to contribute. Hopefully, it should be quite simple at least for Python users.
 
>> The result can be read on readthedocs https://mercurial-book.readthedocs.io
>>
>> The content is for some chapters quite outdated (for example about rollback, mq,
>> etc.). I guess it could be nice to have a new version with updated content but
>> it would require a collective effort.
> 
> 
> Yeah, mq is quite legacy at this point and any mention of rollback
> should be cast away.
> 

I'm going to create few issues to better see what should be done to modernize the book.

> --
> 
> Pierre-Yves David