On 12/20/24 14:13, PIERRE AUGIER wrote:
Hi,
In its current state,https://www.mercurial-scm.org really sends the message
that Mercurial is a dead project, which is not true.
https://wiki.mercurial-scm.org is not much better for some aspects.
However, updatinghttps://www.mercurial-scm.org is not fun because one needs to
write html by hand. It would have to be done, but we could go towards
simplification and send people to a new static site, simpler to maintain.
Revamping the website was discussed during the 5.2 sprint that took
place in 2019 in NYC. As far as I remember there was a clear consensus
back then that we should do it, but the people pushing the effort were
diverted by other works and the Pandemic, so it did not actually
happened. If we want to pick up the torch on that I feel like people
would be happy about it.
I could initiate a simple and nice documentation website hosted
onhttps://mercurial-scm.readthedocs.io. It could look
likehttps://myst-parser.readthedocs.io
Hosting is not the main issue here. We have a server capable of serving
such a static website, and there is plenty of static website
capabilities out there. Building a new website is the main task here.
Once you have something we can publish (and even a draft for it), we can
quickly arrange for it to be published.
The content of hg help could be presented, but a bit nicer than
inhttps://repo.mercurial-scm.org/hg/help. Also other things that one normally
finds in a documentation website.
From my memory, our target for the website is :
- quick overview of the main feature
- download link for the various platform
- documentation / tutorial
- information about hosting option, other supporting tools and
commercial support options
- not being 15 year old.
However I am sure this is missing some items.
I would need a new repo, for
examplehttps://foss.heptapod.net/mercurial/hg-webdoc? Can I create this repo
(or with another name) and start to play?
Why do you need a new repository for that? I think we can reuse the
existing website repository for the new version of the repository.
A related question: is the result
ofhttps://foss.heptapod.net/mercurial/mercurial-devel/-/tree/branch/default/doc
online?
I don't think I understand that question, there is the part included in
hgweb, but we already discussed it together so I feel like your question
is about something else.
--
Pierre-Yves David
_______________________________________________
Mercurial-devel mailing list
Mercurial-devel@lists.mercurial-scm.org
https://lists.mercurial-scm.org/mailman/listinfo/mercurial-devel
