From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on atuin.qyliss.net X-Spam-Level: X-Spam-Status: No, score=-4.6 required=3.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS, MAILING_LIST_MULTI,RCVD_IN_DNSWL_LOW,SPF_HELO_PASS, T_SCC_BODY_TEXT_LINE autolearn=ham autolearn_force=no version=3.4.6 Received: from atuin.qyliss.net (localhost [IPv6:::1]) by atuin.qyliss.net (Postfix) with ESMTP id 6960E2D2BC; Thu, 19 May 2022 10:42:12 +0000 (UTC) Received: by atuin.qyliss.net (Postfix, from userid 496) id 0F9A72D2A3; Thu, 19 May 2022 10:42:09 +0000 (UTC) Received: from out3-smtp.messagingengine.com (out3-smtp.messagingengine.com [66.111.4.27]) by atuin.qyliss.net (Postfix) with ESMTPS id 2D0322D22B for ; Thu, 19 May 2022 10:42:05 +0000 (UTC) Received: from compute5.internal (compute5.nyi.internal [10.202.2.45]) by mailout.nyi.internal (Postfix) with ESMTP id EA1765C0108 for ; Thu, 19 May 2022 06:42:03 -0400 (EDT) Received: from mailfrontend1 ([10.202.2.162]) by compute5.internal (MEProxy); Thu, 19 May 2022 06:42:03 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=alyssa.is; h=cc :content-type:date:date:from:from:in-reply-to:message-id :mime-version:reply-to:sender:subject:subject:to:to; s=fm3; t= 1652956923; x=1653043323; bh=+AmZxS89q8JonYfUMgKEpPo5oJbTE6pqxAg 01ksrF6w=; b=KkwaBrzH21AAMJitj4fWTrH0T7kdslQoVwUbFU25ppCaybaSE4e CEHbgm3kXLSs+0hmToTgy1Ru18f7MwG0BE1YxHyf0qt1dg9pY1/EL5Gr+UATzrNo yvA8T65PDbXSS09xjK3diyoi0pUtirKTzZOPt6PtqyanhNqKkNmGvDmNxwcCcx3F rRKHiXb4R/UN1KGNQGIBvKA37hn9IxmfrLVh0nNfWpoopr9rm+x2IyzKujY+RFVh 7Bj2L3xFqOvvuD+Lk9tFqKfTR/zee9Sjhl5eYG5J1gdMjFF2oM+J3Fx5iUulpHlw BYfE2rnm2h3I+rtX/iHMDKjgE+07OPACQnQ== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-type:date:date:feedback-id :feedback-id:from:from:in-reply-to:message-id:mime-version :reply-to:sender:subject:subject:to:to:x-me-proxy:x-me-proxy :x-me-sender:x-me-sender:x-sasl-enc; s=fm1; t=1652956923; x= 1653043323; bh=+AmZxS89q8JonYfUMgKEpPo5oJbTE6pqxAg01ksrF6w=; b=q S1Dv9ZtJLx1a1ADvUdlYDGbJDWaAGrqNq47B+fyX4yKg65w2icxEyB55EgChW+o8 7m34e14Mj+OQkuHONAeZP0Fms8wiakSCBsxYU7DIWqLP0lJ/w/KHPJh5ITpC1wkJ x7CT2Duu48K3xbqPrHEDyTB0MpvBeIl1ErVVMuuk6xOFfEpNwZ4JAOtNlQ9/Y2iR zEJ6jhAQgnwuHAgwf4thMnrCt6jXVkEDxmvAypZhTXFSRvdB+F62YynIRh7ecumj a9ikm4Sc0bHZAU7zIegsyROT3TqbJ4zDQFearHKeWqIftTqrh8uRRHgrNX3YLOrQ yvE09GlkpTYcdzlwtA5qg== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedvfedriedugddvlecutefuodetggdotefrodftvf curfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfghnecu uegrihhlohhuthemuceftddtnecunecujfgurhepfffhvffukfggtggusehgtderredttd dunecuhfhrohhmpeetlhihshhsrgcutfhoshhsuceohhhisegrlhihshhsrgdrihhsqeen ucggtffrrghtthgvrhhnpeeiuddvleektdevieefgefhffegudeuvdfgfeffieeikeffff eludeiveeugeetkeenucffohhmrghinhepshhpvggtthhruhhmqdhoshdrohhrghdpughi rghtrgigihhsrdhfrhenucevlhhushhtvghrufhiiigvpedtnecurfgrrhgrmhepmhgrih hlfhhrohhmpehqhihlihhsshesvghvvgdrqhihlhhishhsrdhnvght X-ME-Proxy: Feedback-ID: i12284293:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA for ; Thu, 19 May 2022 06:42:03 -0400 (EDT) Received: by eve.qyliss.net (Postfix, from userid 1000) id 21ACD420; Thu, 19 May 2022 10:42:01 +0000 (UTC) Date: Thu, 19 May 2022 10:42:01 +0000 From: Alyssa Ross To: discuss@spectrum-os.org Subject: New documentation site is live! Message-ID: <20220519104201.zqqn32k6rzmanedo@eve> MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="igktjj2eo333mmuo" Content-Disposition: inline Message-ID-Hash: R43E7B5DGJEAVX44BWZ2WEIB3343EEDZ X-Message-ID-Hash: R43E7B5DGJEAVX44BWZ2WEIB3343EEDZ X-MailFrom: qyliss@eve.qyliss.net X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; emergency; loop; banned-address; member-moderation; header-match-config-1; header-match-discuss.spectrum-os.org-0; header-match-discuss.spectrum-os.org-1; nonmember-moderation; administrivia; implicit-dest; max-recipients; max-size; news-moderation; no-subject; digests; suspicious-header X-Mailman-Version: 3.3.5 Precedence: list List-Id: General high-level discussion about Spectrum Archived-At: List-Archive: List-Help: List-Owner: List-Post: List-Subscribe: List-Unsubscribe: --igktjj2eo333mmuo Content-Type: text/plain; charset=iso-8859-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable We finally have an online render of the new documentation I've been writing: https://spectrum-os.org/doc/ Let me know if anything doesn't look right. This documentation lives in the "Documentation" directory in the Spectrum repository. The online version will be automatically updated whenever changes are pushed. I'm not sure what to put on the index page. I think maybe it would make sense to just merge all the content that's currently on the rest of the website into the documentation, but I'm not sure yet. It's going to be really important for Spectrum to have solid documentation. I recently watched a talk about the Di=E1taxis system[1], and I think it would be a good model for us to follow. [1]: https://diataxis.fr/ --igktjj2eo333mmuo Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQIzBAABCAAdFiEEH9wgcxqlHM/ARR3h+dvtSFmyccAFAmKGHvIACgkQ+dvtSFmy ccC59A/+P3PKO1cdSNDZLEuRvleDgYMuCV5tIUuLbQVU7MS+Hp3gmmZv/1kOyCqK vwlnzz+VtOZBvbk7MRw0OvVuD+eycypizt/aU+IJHvLQoxFCSo7KDm49DFRLOzLn VvSIa4n0FL2oYcplso2y0H2ZUOw0D0ERhHuctbdWoYqO1rwEIIjzDEDCBNDS6dVR JI98VNoZBcyOQGVfo2qbQg6zDONiKkgAFiPwZ9nTWEyrEBKPJ/g2/I0+1lCZ7swE MXdEyAkFgPBU2vJ873jf23h16/OIEKzzXGSMFNGAHF74lBYg/LcGAjfBhG9XeX3I toUiabTVMYBqvGzyU2tqzKrN0bVRp4ujPXIwSE0aDCJ+jQItlxYcZdT9/G/ihOqm FlRptDkqlfuaKjTiGnqbZLVJ1vN+chMfLXmC4BUspenKch5Cv7qCcUziUDSCjb8z eUX9/3wTnPpTDtPdvwL2sv27d7Y6i6DnPahBKMCuUqrJf5a17UFiOKupfhGfI1Gp j2COT39PG13fwr6LlBk5iLugzLFgdQSTRF9+rbCAgmtMi+jOw31mnCFLvCnF+nIu S++QNUBIPc8p41WP86Muhz7DF8sZRAia7AegpNTvlpPM8kurtglIDOzMs030RJCW MlzzcMWFQ5lnZsNO7I2qAxEwhp1OomNZtH84IfV1Fq/Ml0jtCm8= =DUuq -----END PGP SIGNATURE----- --igktjj2eo333mmuo--