-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA512 On 2018-01-12 07:58, awokd wrote: > On Fri, January 12, 2018 1:04 pm, Tom Zander wrote: >> On Friday, 12 January 2018 11:18:19 GMT 'awokd' via qubes-users >> wrote: >> >>> Would it be of value if I went through the published Docs and >>> added these version headers? Should newer versions be added at >>> the top (so 4.0 before 3.2 content)? 4.0 might just be "TBD". >>> >> >> I think that would be wonderful, >> >> >> my main issue is with the not knowing if the current docs are >> actually applicable still. If someone could do as much as flag >> known out of date content as 3.2 only, this would be a huge >> help. >> >> The problem of knowing / identifying what isn't actually >> applicable anymore is the main one that I think is causing pain >> right now. > > I have a relatively good amount of experience so should be able to > call out which is which on sight. If not, I can I point that out > too in the 4.0 TBD section. >
That would be very helpful! Thank you! > To your point, some of these docs are pretty version specific. > https://www.qubes-os.org/doc/qubes-r3-building/ as a possibly bad > example. It's similar to the 4.0 build procedure but at least the > name should be generalized then. I think I agree with you those > should be separated. I'll plan on skipping them for now. > > I'm a bit concerned it's going to result in ugly looking documents > too, but at least by splitting out the contents now it will be > easier in the future to move into separate documents if we go that > route. > Doing this will provide evidence that helps us decide which system to us. For example, if it turns out that nearly every document has to be split into two sections, that might be a strong indication that there should just be two sets of documents. But if it's only 30%, or if it's usually just certain sections *within* documents, for example, then it might make more sense to stick with the current system. - -- Andrew David Wong (Axon) Community Manager, Qubes OS https://www.qubes-os.org -----BEGIN PGP SIGNATURE----- iQIzBAEBCgAdFiEEZQ7rCYX0j3henGH1203TvDlQMDAFAlpZcjIACgkQ203TvDlQ MDBB8hAAhuP4K0RtpYbTQoDRSKjomgx7q3TWZUziYNJ7TE2MCgDiGCqs7Bdh8Pk7 4PgNlkOOTVUEgq4ehOgCXbTEL/Gofaat2vrxdPDcXl94Gd4Oi9dhN6c2SGBEAhkL nkyjY6iXxTRBd0+duqI4jN5CIAUcxOPqV+D/naQaLS2uiRX73rwJkAYDHOhiRUY1 hjd+iLK1AzGjjqJs7yBn2UshxwIMZnEHn7GnwzbI1at+vFOIXLaMk5xIEUiekICL +9NeC4ijbOVYIni6UjiJ4Dtr1sGk0Nm8XNHKve5/YOlQEDcciXDFk158yZmYUcR+ h9XwV4afPpSe17p+SZiZLG4UkYjner1GSPY5GhbqHM5+FpYEeWmCbkiSBI9HAEiZ 6PMSUwY2yLJ9V7jQHhzbCqYeLDKcsssn/VmNrcH8aPjrs8dDAxmSYHt+Q0O3mn5G Ka4zgCt6t91PUxYIE2HqAQB3mOSLtKd8gp3rmgkR/HcawSxQfy8Oh6atYMnTu2fG 5G3g407cwwXWedSO9CrqkNz9anCt2MjVKnTXy5j0q0OQtkC7n8GwOz7Q8nPAnH27 WGUlp+0dG6PlLn/MqiR66JdxFMmfv37ATwXj03Zol0JY51B3kczeXzsB5ky6zi2T T9YjFN0oiJFA3fxCt4iMc51vSB56ufYG5yROCnhbdsfksYU59sQ= =EGor -----END PGP SIGNATURE----- -- You received this message because you are subscribed to the Google Groups "qubes-users" group. To unsubscribe from this group and stop receiving emails from it, send an email to qubes-users+unsubscr...@googlegroups.com. To post to this group, send email to email@example.com. To view this discussion on the web visit https://groups.google.com/d/msgid/qubes-users/d4c9f2f6-d3ed-e018-c4f0-ed281b1434ab%40qubes-os.org. For more options, visit https://groups.google.com/d/optout.