From mboxrd@z Thu Jan 1 00:00:00 1970 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on inbox.vuxu.org X-Spam-Level: X-Spam-Status: No, score=-3.4 required=5.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,MAILING_LIST_MULTI,RCVD_IN_DNSWL_MED,UNPARSEABLE_RELAY autolearn=ham autolearn_force=no version=3.4.4 Received: (qmail 25882 invoked from network); 29 Mar 2021 01:20:41 -0000 Received: from zero.zsh.org (2a02:898:31:0:48:4558:7a:7368) by inbox.vuxu.org with ESMTPUTF8; 29 Mar 2021 01:20:41 -0000 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=zsh.org; s=rsa-20200801; h=List-Archive:List-Owner:List-Post:List-Unsubscribe: List-Subscribe:List-Help:List-Id:Sender:Message-ID:Date:Content-ID: Content-Type:MIME-Version:Subject:To:References:From:In-reply-to:cc:Reply-To: Content-Transfer-Encoding:Content-Description:Resent-Date:Resent-From: Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID; bh=hREp8VD4R6nObnz4hpoUqPscQsvZth4SjNVRGxZ+pCI=; b=E4ESRyGkjcOo/Ib5873Qe4lJyA 2VHBsUXSAo6Wp9u9Cup7BsmLsLKifFYcVDTXGH2O3GilD7bj1n0LymsJGonNB0r2uCQAS4OaI18vj +3iY4z7Jq6wr297rR47NhZLeiLKkcTNPmtYvj3Z4DcDaOQPladO4zdijlBPx9Zjidh01R4Ioq8CQ7 ScuLFNwvz6h904H7+kECYUc3oNVliUGW0FEULwgNsvuimTmTEUB48S1fXqG9bSCvoT40QtuZxSUl+ OqOq4oGoLZ43dWxtGATxQqTRk4Uy3uzq9oJ4SRB2WylJfLPuINqS2Pay95v+7K4XI4ol+UElfhwlM 4UF/8ymg==; Received: from authenticated user by zero.zsh.org with local id 1lQga7-0004wp-Pz; Mon, 29 Mar 2021 01:20:39 +0000 Received: from authenticated user by zero.zsh.org with esmtpsa (TLS1.3:TLS_AES_256_GCM_SHA384:256) id 1lQgZp-0004nn-Tl; Mon, 29 Mar 2021 01:20:22 +0000 Received: from [192.168.178.21] (helo=hydra) by mail.kiddle.eu with esmtp(Exim 4.93.0.4) (envelope-from ) id 1lQgZn-000M3K-UL; Mon, 29 Mar 2021 03:20:20 +0200 cc: zsh-workers@zsh.org In-reply-to: <481B0356-2B76-415A-8C1E-2BB6828420FC@icloud.com> From: Oliver Kiddle References: <81983-1616976142.953383@GxW7.Jtw5.jOhI> <481B0356-2B76-415A-8C1E-2BB6828420FC@icloud.com> To: Austin Traver Subject: Re: I'd like to help maintain the Zsh Web Page MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-ID: <84772.1616980819.1@hydra> Date: Mon, 29 Mar 2021 03:20:19 +0200 Message-ID: <84773-1616980819.919111@ybx2.QGzt.Gdnm> X-Seq: 48300 Archived-At: X-Loop: zsh-workers@zsh.org Errors-To: zsh-workers-owner@zsh.org Precedence: list Precedence: bulk Sender: zsh-workers-request@zsh.org X-no-archive: yes List-Id: List-Help: List-Subscribe: List-Unsubscribe: List-Post: List-Owner: List-Archive: Archived-At: Austin Traver wrote: > I feel the exact same way. Markdown is a great fit. > I'd need to start by replicating the documentation in the equivalent > markdown. The actual documentation is something of a different matter. That's not written in HTML but in a macro language named yodl that converts to any of man pages, HTML or texinfo (from which it can be rendered to PDF, info pages and other formats). The man pages are possibly the most important form for the documentation. I'm not sure whether that can be replicated from markdown but it really would need to be. texi2html is quite configurable if we just want to tweak the web version of the documentation. I'm not saying it has to be this way forever but take the time to understand it first so you don't end up doing a lot of work that goes to waste. > What repositories host the Zsh documentation, is there a clone on GitHub I can fork? The documentation is in a Doc directory alongside the source code - https://git.code.sf.net/p/zsh/code There are mirrors on github and gitlab if you prefer. Sourceforge website content is https://git.code.sf.net/p/zsh/web zsh.org website content is only the one file, so curl or saving from firefox is probably easiest. Oliver