From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: the Emacs wiki Date: Sat, 06 Dec 2014 12:58:36 +0200 Message-ID: <837fy511ur.fsf@gnu.org> References: <20141203142859.24393.98673@vcs.savannah.gnu.org> <20141203192721.GE12748@thyrsus.com> <547F6774.50700@cs.ucla.edu> <838uio5vjw.fsf@gnu.org> <20141203211447.GB15111@thyrsus.com> <871toge5zw.fsf@floss.red-bean.com> <83388v6hsq.fsf@gnu.org> <87egsftgd5.fsf@ktab.red-bean.com> <83egsf3yci.fsf@gnu.org> <20141204230131.5eea855f@forcix> <837fy64lq6.fsf@gnu.org> <8561dpjc0i.fsf_-_@stephe-leake.org> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1417863522 15932 80.91.229.3 (6 Dec 2014 10:58:42 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 6 Dec 2014 10:58:42 +0000 (UTC) Cc: emacs-devel@gnu.org To: Stephen Leake Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Dec 06 11:58:35 2014 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1XxD4N-0000c9-5B for ged-emacs-devel@m.gmane.org; Sat, 06 Dec 2014 11:58:35 +0100 Original-Received: from localhost ([::1]:54034 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XxD4M-0006jQ-Ro for ged-emacs-devel@m.gmane.org; Sat, 06 Dec 2014 05:58:34 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:45229) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XxD4D-0006hC-Ki for emacs-devel@gnu.org; Sat, 06 Dec 2014 05:58:31 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1XxD47-0006kr-BC for emacs-devel@gnu.org; Sat, 06 Dec 2014 05:58:25 -0500 Original-Received: from mtaout24.012.net.il ([80.179.55.180]:42029) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XxD46-0006kZ-V6 for emacs-devel@gnu.org; Sat, 06 Dec 2014 05:58:19 -0500 Original-Received: from conversion-daemon.mtaout24.012.net.il by mtaout24.012.net.il (HyperSendmail v2007.08) id <0NG500A00PQI2H00@mtaout24.012.net.il> for emacs-devel@gnu.org; Sat, 06 Dec 2014 12:50:32 +0200 (IST) Original-Received: from HOME-C4E4A596F7 ([87.69.4.28]) by mtaout24.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0NG500A22Q48A310@mtaout24.012.net.il>; Sat, 06 Dec 2014 12:50:32 +0200 (IST) In-reply-to: <8561dpjc0i.fsf_-_@stephe-leake.org> X-012-Sender: halo1@inter.net.il X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 80.179.55.180 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:179149 Archived-At: > From: Stephen Leake > Date: Sat, 06 Dec 2014 04:41:49 -0600 > > What is the intended process for maintaining the wiki? > > Suppose I want to clean up all references to Bazaar, and make sure the > wiki presents a clear and consistent picture of the Emacs development > process? > > I can easily do that in ./CONTRIBUTE, because it will be reviewed by the > other Emacs developers. > > Finding things in the wiki is a nightmare. Maintaining them is worse. > > I don't mind maintaining one or two wiki pages, as long as they are referenced > from CONTRIBUTE as important web pages. That's my concession to the "we must > use the web" bandwagon. Anything more than that is unmaintainable. > > It would make more sense if there was a higher-level wiki page that was > well maintained, that talked more about Emacs in general, not just how > to use git. (You forgot to mention that the Wiki stuff is uncontrolled and therefore its quality sucks.) Wiki is a hydra you cannot cut enough heads off to make it die. I tried, and failed miserably. I suggest you don't waste your efforts and time on that. Ideally, everything that's valuable on the Wiki should be in some manual under doc/misc/. But there are people out there that just cannot be convinced, and I stopped trying. The best we can do is to add such manuals to Emacs, maintain them to be always up to date, and hope that the Wiki will die of natural causes, because it falls behind. But adding that stuff under doc/ requires a dedicated volunteer, which is hard to get by, because the job sounds like a waste of resources (and in some sense, it really is). Bottom line, I suggest that we make the best effort we can to have our documentation in this area as good as it gets, and turn a blind eye towards the Wiki. Then, if people come up, here or on help-gnu-emacs, complaining that the Wiki says something that isn't correct, we could just tell them that the Wiki isn't supported by the project, and advise them to look at our documents instead.