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,FREEMAIL_FROM,MAILING_LIST_MULTI,RCVD_IN_DNSWL_MED, UNPARSEABLE_RELAY autolearn=ham autolearn_force=no version=3.4.4 Received: (qmail 21406 invoked from network); 29 Mar 2021 00:39:56 -0000 Received: from zero.zsh.org (2a02:898:31:0:48:4558:7a:7368) by inbox.vuxu.org with ESMTPUTF8; 29 Mar 2021 00:39:56 -0000 ARC-Seal: i=1; cv=none; a=rsa-sha256; d=zsh.org; s=rsa-20200801; t=1616978396; b=DzUScvYZ+4RrQkjfp+X9+JG3+V0IneOiUYmgY/FyxuWKXh2n/24rKOXdkHT2BxyZDLg5syRPKE NtlCl7y3enuuKsxXdEkbEwsoF/EJZzxwhlRXTPKiVw5SstgwaUGF4++JfSOSW3x3r5VIsR7fnl XlbkOtf2GKLP3Fv9OT/qEflvUW1+2L/AQjWRs0+ZW9/yyq21aW4/53+mVQeP/s8COxnZH5ujGw k4PtU+EJlA6czkaANsRkfTZxlJu0YtOOjYYTS/XCsnNH5kUk2LbcuSs46VdNvwQw+BhvCLA6Rm HLYDwwMolJkoFl4WoJxTZku0N4wn9aAbHsgJ/a9M59GE3g==; ARC-Authentication-Results: i=1; zsh.org; iprev=pass (mr85p00im-ztdg06021801.me.com) smtp.remote-ip=17.58.23.195; dkim=pass header.d=icloud.com header.s=1a1hai header.a=rsa-sha256; dmarc=pass header.from=icloud.com; arc=none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed; d=zsh.org; s=rsa-20200801; t=1616978396; bh=AZBrNlIX/Ne4HXHVUKdxVhFJWL4z2SrRlM9hQXlTfeE=; h=List-Archive:List-Owner:List-Post:List-Unsubscribe:List-Subscribe:List-Help: List-Id:Sender:To:In-Reply-To:Cc:References:Message-ID:Date:Subject: MIME-Version:From:Content-Transfer-Encoding:Content-Type:DKIM-Signature: DKIM-Signature; b=SWeGBZTwdxRW+aJuXKK4W1d+6v6izr16c9q9lN0b8QwEO2eobitBw9/NjC6gByHZLjXxc3mb44 CD1INWl6iSAUykNxMP9GQGKZ5WnYNtMo6DjZjRyH2BYWPldJCWYHZAHo/gsvNmhTjfyAtgQveB dqMI2g822q5amTYKuwooTlEi62O0bJK1df7wg7IEzsPiQI5iX7k3mFADooiuBKYWC4WUjB/3Si s3xyf4LnTRGvseVq7sWFAyiSB/5G3W+oDB+f01yZUzDq/whGzjkyxgCso+6NVnSW5xA4wVajHI tVc9DhbXekSQIa5GlEn9aTQnMZEmevwkJpqhworDp0B3RQ==; 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:To:In-Reply-To:Cc:References: Message-Id:Date:Subject:Mime-Version:From:Content-Transfer-Encoding: Content-Type:Reply-To:Content-ID:Content-Description:Resent-Date:Resent-From: Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID; bh=AZBrNlIX/Ne4HXHVUKdxVhFJWL4z2SrRlM9hQXlTfeE=; b=Ao9QHjV+1hkSmrKtIWdVek3l6D iig9RICIlXc8ASHo/T63Fgsmg4FZ+NjQ6pP/xDt69vL7KvyiZd1w3DrHo2EUlKmKpqUqhJa9iND/H QxfMNiEDnOQc6iSUmHFRl4DPjUN8XrPOrpWi7SE+2oVTlnTAbsIkeqe6jaWshu5QagQT0/2VYtF+T pp08JE9+OKV40nd+c2RyfglmRTYBEBYaLsG3HA+tJzYOekjs+pe7cP1ky1yZkledSeZO6iCwtVz6T lZ2TNNXtZ+BGQwtJ3NbLjcP/4ayLxxcLKQ03RdbPoLz4AOA1nD9GIXYliVD8pgRJBW0nMzKK9YO04 IVLyE0/w==; Received: from authenticated user by zero.zsh.org with local id 1lQfwf-0003SS-AN; Mon, 29 Mar 2021 00:39:53 +0000 Authentication-Results: zsh.org; iprev=pass (mr85p00im-ztdg06021801.me.com) smtp.remote-ip=17.58.23.195; dkim=pass header.d=icloud.com header.s=1a1hai header.a=rsa-sha256; dmarc=pass header.from=icloud.com; arc=none Received: from mr85p00im-ztdg06021801.me.com ([17.58.23.195]:40525) by zero.zsh.org with esmtps (TLS1.2:ECDHE-RSA-AES256-GCM-SHA384:256) id 1lQfwO-0003IY-AP; Mon, 29 Mar 2021 00:39:37 +0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=icloud.com; s=1a1hai; t=1616978374; bh=AZBrNlIX/Ne4HXHVUKdxVhFJWL4z2SrRlM9hQXlTfeE=; h=Content-Type:From:Mime-Version:Subject:Date:Message-Id:To; b=sXJBNYjIRsioLp5cWQyx6yuUZ8oq9R6i9h+ua/o0lfQ8ETbMBBuJwh7H/a++UDjVk EKohiC0jQ/9Esf5cn8owqoq3taRuPN+9bm+FCtFxzuctld/Tp+DiMzdzgY7ao80s9l 9tXHy8in53g4ptqZ8cXuC9IIDJbjOM5QMIvFZB33kkAA5RVv18qt8sXEhrosUskavD 2KP8QGeX58RCesjtrIxBSaZWNNARj6sTf9ep2dgoW8QKf8yI5unbZYFbU4lodi+Js8 jcgsGG7eB1uR58zfuGHd9HNzOfeTMnhp1GL/RxWkjwQnsZDHTgDg5qHe+HXpexE22u CHt+m5TZYrumQ== Received: from [100.65.23.159] (unknown [64.136.145.104]) by mr85p00im-ztdg06021801.me.com (Postfix) with ESMTPSA id 7FDC51800F8; Mon, 29 Mar 2021 00:39:34 +0000 (UTC) Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable From: Austin Traver Mime-Version: 1.0 (1.0) Subject: Re: I'd like to help maintain the Zsh Web Page Date: Sun, 28 Mar 2021 17:39:33 -0700 Message-Id: <481B0356-2B76-415A-8C1E-2BB6828420FC@icloud.com> References: <81983-1616976142.953383@GxW7.Jtw5.jOhI> Cc: zsh-workers@zsh.org In-Reply-To: <81983-1616976142.953383@GxW7.Jtw5.jOhI> To: Oliver Kiddle X-Mailer: iPhone Mail (18D61) X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:6.0.369,18.0.761 definitions=2021-03-28_14:2021-03-26,2021-03-28 signatures=0 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=0 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 clxscore=1011 mlxscore=0 mlxlogscore=886 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-2006250000 definitions=main-2103290001 X-Seq: 48298 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: I'm absolutely interested. I think=20 > It is probably best to keep the design relatively > conservative - the 1995-era design looks less bad now than a 2005 one > would. Preferably no cookies or required JavaScript but a touch of CSS > wouldn't do much harm. A markdown based static templating preprocessor > such as jekyll would be fine if it can run on the existing hosting > without complicated install procedures. I feel the exact same way. Markdown is a great fit. As far as using Jekyll, I think Hugo is a better choice for long term reliab= ility. But anyhow, post processing is getting ahead of ourselves. I'd need t= o start by replicating the documentation in the equivalent markdown. What repositories host the Zsh documentation, is there a clone on GitHub I c= an fork? Best, Austin > On Mar 28, 2021, at 5:02 PM, Oliver Kiddle wrote: >=20 > =EF=BB=BFAustin Traver wrote: >> My name is Austin. I'm a graduate student in the United States, studying >> computer science. I have been Zsh for a few years now, and I've become qu= ite >> passionate about it, sharing [1]my knowledge so far with others along the= way. >>=20 >> I'd like to help maintain the Zsh site, as I think reliable, usable >> documentation plays a vital role in understanding software.=20 >>=20 >> Is there any job, big or small, that you could think of, for me? >=20 > Aside from the documentation, the design, structure, layout and > content of the web pages could do with updating, modernising and being > maintained over the longer term. >=20 > It'd be quite nice to unify what we have at https://www.zsh.org/ with > http://zsh.sourceforge.net/ so that sourceforge is just a mirror of the > other URL and preserving content from both. >=20 > The current site is done in old hand-written HTML that hasn't > changed much ever. It is probably best to keep the design relatively > conservative - the 1995-era design looks less bad now than a 2005 one > would. Preferably no cookies or required JavaScript but a touch of CSS > wouldn't do much harm. A markdown based static templating preprocessor > such as jekyll would be fine if it can run on the existing hosting > without complicated install procedures. Currently, there is a certain > amount of duplicated boiler-plate HTML. >=20 > If you or whoever else is interested, I can point you in the direction > of relevant git repositories where the existing content sits. >=20 > Oliver