Received: from malur.postgresql.org ([2a02:16a8:dc51::56]) by arkaria.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA384:256) (Exim 4.89) (envelope-from ) id 1fwya1-0004cQ-3N for pgsql-docs@arkaria.postgresql.org; Mon, 03 Sep 2018 23:48:25 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.89) (envelope-from ) id 1fwyZz-0000no-2c for pgsql-docs@arkaria.postgresql.org; Mon, 03 Sep 2018 23:48:23 +0000 Received: from magus.postgresql.org ([2a02:c0:301:0:ffff::29]) by malur.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA384:256) (Exim 4.89) (envelope-from ) id 1fwyZy-0000ng-Sy for pgsql-docs@lists.postgresql.org; Mon, 03 Sep 2018 23:48:22 +0000 Received: from out1-smtp.messagingengine.com ([66.111.4.25]) by magus.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA384:256) (Exim 4.89) (envelope-from ) id 1fwyZv-0003Xo-35 for pgsql-docs@lists.postgresql.org; Mon, 03 Sep 2018 23:48:22 +0000 Received: from compute4.internal (compute4.nyi.internal [10.202.2.44]) by mailout.nyi.internal (Postfix) with ESMTP id C5A4121BA5; Mon, 3 Sep 2018 19:48:17 -0400 (EDT) Received: from mailfrontend2 ([10.202.2.163]) by compute4.internal (MEProxy); Mon, 03 Sep 2018 19:48:17 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=paquier.xyz; h= content-type:date:from:in-reply-to:message-id:mime-version :references:subject:to:x-me-sender:x-me-sender:x-sasl-enc; s= fm2; bh=jEg+rhr5Qy02qSdQhxuEaJPEdFonDJkrIb4HNIbi3M0=; b=ZUi0ujj0 vbOIeep2oiVEtmZbcQRvlZnXViTejlS3eSqOoBIx3/aI6Dd/UYFh94T5HxYnLWrj In/Ty7lthPYTk5xUSfRHIrG/Fr5khvKSBXYzJCJzxDFwXJAohqygcZNecR/40psx k29c+GuVCg2gMMnI/92uCJQi4K4L1ieDq3AnVamdS6HC6IH7K71SJVp7Flyu0T57 0TpE2IRZtWx2Iq8X8m1bXCE2NFvutsrvFu6Iu+deowVFtCfErh3xldhuXhbxeGQ7 0FT/W+NPQX0AvukN1njWCtdUqrZbGHpQUzC06moue5Lbdu9/N/AdgBAmYcNogPZr 12wlPGL6EGNa7w== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=content-type:date:from:in-reply-to :message-id:mime-version:references:subject:to:x-me-sender :x-me-sender:x-sasl-enc; s=fm3; bh=jEg+rhr5Qy02qSdQhxuEaJPEdFonD JkrIb4HNIbi3M0=; b=Ffw2vvF6/iYO2wzVTnL9zORyq3jHFt4xQKHdmyOwWJ4FD 2w703haLeumJRxp4YEGjVfu/0rVhnzMZ9VkGD0qTrDT/9u9E5ELvpKXUrXehZvik rRLG85Bot5iUapV5dXRWJPF/H88XaoAAPcz5yXMew9mgAzpfR3VSzpeg2EG2d5z2 kjpkl6HLFp1sdf1r4r60zMCCCQIwWyH4OWqyOw4PPSq0uD5Sw+yJkx6RCa8jK2zM XS2F8V1alS16946HGD/JYPARacEzMeuYrxMG8FuNp8LeSTlJZwjIjoVH9ib+QXsy 9D5Lv1O47QW6oPJggPm8xGXTsC5AOQEudoUWCuUrA== X-ME-Proxy: X-ME-Sender: Received: from paquier.xyz (unknown [208.91.3.26]) by mail.messagingengine.com (Postfix) with ESMTPA id 6DA4D1029C; Mon, 3 Sep 2018 19:48:16 -0400 (EDT) Date: Mon, 3 Sep 2018 16:48:14 -0700 From: Michael Paquier To: bad.banana@outlook.com, pgsql-docs@lists.postgresql.org Subject: Re: you need this kind of explanation Message-ID: <20180903234814.GF1343@paquier.xyz> References: <153596193325.31913.9299011657476057037@wrigleys.postgresql.org> MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha512; protocol="application/pgp-signature"; boundary="OFj+1YLvsEfSXdCH" Content-Disposition: inline In-Reply-To: <153596193325.31913.9299011657476057037@wrigleys.postgresql.org> List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Precedence: bulk --OFj+1YLvsEfSXdCH Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Mon, Sep 03, 2018 at 08:05:33AM +0000, PG Doc comments form wrote: > The following documentation comment has been logged on the website: >=20 > Page: https://www.postgresql.org/docs/10/static/index.html > Description: >=20 > right off the bat, you should have this kind of explanation up there in > chapter 1: > https://www.liquidweb.com/kb/what-is-the-default-password-for-postgresql/ >=20 > this will orient any noobs immediately. >=20 > also, the word "role" and "user" should not be used interchangebly. they > mean different things. If you have any improvements that you think are adapted about the documentation of Postgres, please feel free to provide any patch of base patch that you could use for discussion. I am not sure if any kind of information provided in the blog post you are mentioning above makes much sense though, as the way Postgres is packaged, installed, deployed and configured depends heavily on the way a given distribution or OS wants to set it up, which could have many different requirements. -- Michael --OFj+1YLvsEfSXdCH Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQIzBAABCgAdFiEEG72nH6vTowiyblFKnvQgOdbyQH0FAluNyD4ACgkQnvQgOdby QH0Vbg//WGDTJtvFCVAhYqgFNcwFLiD/ta8WUM2EAPJJNsfxLCAdLQUN8jwx2/O0 kGR4+eAm5A33S+Y8YfH+6SOGIjjP7QIgQvW4rk2ih6YkCoFsjv2WCwa+RhyGO0rO RQdb0jiDVrJ1lONxXfqPQveVzU5GFn8MQ8nu0XAOu2eyTnQnaDsiX02S1Qc9Ab4P 5GH6mrnraRL6UUHtl60cWuifE8FudW9bDV7ckn5CRGrxdub15pSuNekFh1X08FCU AN8s1uvUSRtF7kCP3FYavANaRKJzBoEXYV5i+y0kR2Rneh8f6ACcOT3t2zL+1fv4 poDamBjHAZjAsd1DJ+7mhtWL7JoLy45oWe96ywX60KjlqgfZlA8PiWaiAOeaexSs 3IM5d20X84cQ67qrq7L1euBZDLnavoTo/oR+4pbu4f2fQlPjrQT79+sfL7IgPZXM 8uUcFVgGX17GwqaVaVVdvHoFKweJHnkGI7hIR1gUT4P3xKUmAZLkAuvwm6wVEKTI +4yzO4YgOgb8h/AC6rDVmWcLgENWYsET3ewCHyzbkgTUHpydVronG520EF6KgQQ+ OhGvuN5rQOrckQHZ5kmOGbo9r7sm4dOHiHE9j57WbFcfyWjOJM3E3fozWP3Qztfk NJxpOgqi/8RZRLafp4dpntwduPALDUHdugPW9GLcjJ04t82rtao= =YfJA -----END PGP SIGNATURE----- --OFj+1YLvsEfSXdCH--