Re: please weigh in on fate of old docs! [was Re: we gotta bury the old docs]
mowestusa <[email protected]> Sat, 27 Nov 2021 02:15:35 +0000 (UTC)
| Newsgroups | gmane.linux.redhat.fedora.documentation |
|---|---|
| Message-ID | <[email protected]> |
--===============0959307017291805187== Content-Type: multipart/alternative; boundary="----=_Part_3924150_1271926745.1637979335209" ------=_Part_3924150_1271926745.1637979335209 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit Not that I have much weight, because of lack of participation, but I think this is a great idea. Finding obsolete documentation as users can be frustrating. I agreed with all parts of the "Proposed path forward" in Issue 183. At one time I had started reading the documentation looking for ways to eliminate and replace with all specific reference to release #'s with general references so that when a user gets to the documentation site it always reads as if this works for the current version of Fedora. Then I wondered what would happen if in the next release something did change making that piece of documentation only applicable to the previous release, how would you find those easily and to make the documentation catch up with the current release. Thanks Matthew for finding an additional way to put more polish on a great distribution. ---------------------------------------------- | Steve | [email protected] | ---------------------------------------------- On Friday, November 26, 2021, 03:41:02 PM EST, Matthew Miller <[email protected]> wrote: On Fri, Nov 26, 2021 at 02:32:03PM -0500, Matthew Miller wrote: > Let's make that decision now, then. Heading to > https://pagure.io/fedora-docs/docs-fp-o/issue/118 to not split the > discussion. Proposed path forward: https://pagure.io/fedora-docs/docs-fp-o/issue/183 -- Matthew Miller <[email protected]> Fedora Project Leader _______________________________________________ docs mailing list -- [email protected] To unsubscribe send an email to [email protected] Fedora Code of Conduct: https://docs.fedoraproject.org/en-US/project/code-of-conduct/ List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines List Archives: https://lists.fedoraproject.org/archives/list/[email protected] Do not reply to spam on the list, report it: https://pagure.io/fedora-infrastructure ------=_Part_3924150_1271926745.1637979335209 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable <html><head></head><body><div class=3D"ydpfd8aa2f0yahoo-style-wrap" style= =3D"font-family:Helvetica Neue, Helvetica, Arial, sans-serif;font-size:16px= ;"><div><div dir=3D"ltr" data-setdir=3D"false">Not that I have much weight,= because of lack of participation, but I think this is a great idea. Findin= g obsolete documentation as users can be frustrating. I agreed with all par= ts of the "Proposed path forward" in Issue 183.<br></div><div dir=3D"ltr" d= ata-setdir=3D"false"><br></div><div dir=3D"ltr" data-setdir=3D"false"> At o= ne time I had started reading the documentation looking for ways to elimina= te and replace with all specific reference to release #'s with general refe= rences so that when a user gets to the documentation site it always reads a= s if this works for the current version of Fedora. Then I wondered what wou= ld happen if in the next release something did change making that piece of = documentation only applicable to the previous release, how would you find t= hose easily and to make the documentation catch up with the current release= .</div><div dir=3D"ltr" data-setdir=3D"false"><br></div><div dir=3D"ltr" da= ta-setdir=3D"false">Thanks Matthew for finding an additional way to put mor= e polish on a great distribution.<br></div><div><br></div><div class=3D"ydp= fd8aa2f0signature"><div style=3D"font-family:Helvetica, Arial, sans-serif;f= ont-size:16px;"><div>---------------------------------------------- <br></d= iv><div>| Steve | [email protected] |</div><div> ------------------------= ----------------------</div></div></div></div> <div><br></div><div><br></div> =20 </div><div id=3D"yahoo_quoted_8338026876" class=3D"yahoo_quoted"> <div style=3D"font-family:'Helvetica Neue', Helvetica, Arial, s= ans-serif;font-size:13px;color:#26282a;"> =20 <div> On Friday, November 26, 2021, 03:41:02 PM EST, Matthew = Miller <[email protected]> wrote: </div> <div><br></div> <div><br></div> <div>On Fri, Nov 26, 2021 at 02:32:03PM -0500, Matthew Mill= er wrote:<br clear=3D"none">> Let's make that decision now, then. Headin= g to<br clear=3D"none">> <a shape=3D"rect" href=3D"https://pagure.io/fed= ora-docs/docs-fp-o/issue/118 " target=3D"_blank">https://pagure.io/fedora-d= ocs/docs-fp-o/issue/118 </a>to not split the<br clear=3D"none">> discuss= ion.<br clear=3D"none"><br clear=3D"none">Proposed path forward: <a shape= =3D"rect" href=3D"https://pagure.io/fedora-docs/docs-fp-o/issue/183" target= =3D"_blank">https://pagure.io/fedora-docs/docs-fp-o/issue/183</a><div class= =3D"yqt0991569203" id=3D"yqtfd79540"><br clear=3D"none"><br clear=3D"none">= <br clear=3D"none">-- <br clear=3D"none">Matthew Miller<br clear=3D"none">&= lt;<a shape=3D"rect" ymailto=3D"mailto:[email protected]" href=3D"ma= ilto:[email protected]">[email protected]</a>><br clear=3D= "none">Fedora Project Leader<br clear=3D"none">____________________________= ___________________<br clear=3D"none">docs mailing list -- <a shape=3D"rect= " ymailto=3D"mailto:[email protected]" href=3D"mailto:docs@lists= .fedoraproject.org">[email protected]</a><br clear=3D"none">To u= nsubscribe send an email to <a shape=3D"rect" ymailto=3D"mailto:docs-leave@= lists.fedoraproject.org" href=3D"mailto:[email protected]"= >[email protected]</a><br clear=3D"none">Fedora Code of Co= nduct: <a shape=3D"rect" href=3D"https://docs.fedoraproject.org/en-US/proje= ct/code-of-conduct/" target=3D"_blank">https://docs.fedoraproject.org/en-US= /project/code-of-conduct/</a><br clear=3D"none">List Guidelines: <a shape= =3D"rect" href=3D"https://fedoraproject.org/wiki/Mailing_list_guidelines" t= arget=3D"_blank">https://fedoraproject.org/wiki/Mailing_list_guidelines</a>= <br clear=3D"none">List Archives: <a shape=3D"rect" href=3D"https://lists.f= edoraproject.org/archives/list/[email protected]" target=3D"_bla= nk">https://lists.fedoraproject.org/archives/list/[email protected].= org</a><br clear=3D"none">Do not reply to spam on the list, report it: <a s= hape=3D"rect" href=3D"https://pagure.io/fedora-infrastructure" target=3D"_b= lank">https://pagure.io/fedora-infrastructure</a><br clear=3D"none"></div><= /div> </div> </div></body></html> ------=_Part_3924150_1271926745.1637979335209-- --===============0959307017291805187== Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: base64 Content-Disposition: inline X19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX18KZG9jcyBtYWls aW5nIGxpc3QgLS0gZG9jc0BsaXN0cy5mZWRvcmFwcm9qZWN0Lm9yZwpUbyB1bnN1YnNjcmliZSBz ZW5kIGFuIGVtYWlsIHRvIGRvY3MtbGVhdmVAbGlzdHMuZmVkb3JhcHJvamVjdC5vcmcKRmVkb3Jh IENvZGUgb2YgQ29uZHVjdDogaHR0cHM6Ly9kb2NzLmZlZG9yYXByb2plY3Qub3JnL2VuLVVTL3By b2plY3QvY29kZS1vZi1jb25kdWN0LwpMaXN0IEd1aWRlbGluZXM6IGh0dHBzOi8vZmVkb3JhcHJv amVjdC5vcmcvd2lraS9NYWlsaW5nX2xpc3RfZ3VpZGVsaW5lcwpMaXN0IEFyY2hpdmVzOiBodHRw czovL2xpc3RzLmZlZG9yYXByb2plY3Qub3JnL2FyY2hpdmVzL2xpc3QvZG9jc0BsaXN0cy5mZWRv cmFwcm9qZWN0Lm9yZwpEbyBub3QgcmVwbHkgdG8gc3BhbSBvbiB0aGUgbGlzdCwgcmVwb3J0IGl0 OiBodHRwczovL3BhZ3VyZS5pby9mZWRvcmEtaW5mcmFzdHJ1Y3R1cmUK --===============0959307017291805187==--