Re: please weigh in on fate of old docs! [was Re: we gotta bury the old docs]
Leslie S Satenstein <[email protected]> Sat, 27 Nov 2021 22:10:19 +0000 (UTC)
| Newsgroups | gmane.linux.redhat.fedora.documentation |
|---|---|
| Message-ID | <[email protected]> |
--===============5869599298234332738==
Content-Type: multipart/alternative;
boundary="----=_Part_5940861_379990589.1638051019042"
------=_Part_5940861_379990589.1638051019042
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: quoted-printable
My experience -- old docs are for museums.=C2=A0 Quite often, the documente=
d function name has been changed a few releases ago, and much after the ori=
ginal implementation.In searching for the function explanation, obsolete in=
formation turns up to confuse the reader.Perhaps too, a release date should=
be attached to each topic.
I like the idea of having 3 generations of docs, some paragraph that says d=
estroy by yyyy.mm.dd.
Regards=20
=C2=A0Leslie
Leslie Satenstein
Montr=C3=A9al Qu=C3=A9bec, Canada
=20
On Friday, November 26, 2021, 03:41:02 p.m. EST, Matthew Miller <mattdm=
@fedoraproject.org> wrote: =20
=20
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
--=20
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-o=
f-conduct/
List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines
List Archives: https://lists.fedoraproject.org/archives/list/[email protected]=
oraproject.org
Do not reply to spam on the list, report it: https://pagure.io/fedora-infra=
structure
=20
------=_Part_5940861_379990589.1638051019042
Content-Type: text/html; charset=UTF-8
Content-Transfer-Encoding: quoted-printable
<html><head></head><body><div class=3D"ydp549e3551yahoo-style-wrap" style=
=3D"font-family: Helvetica Neue, Helvetica, Arial, sans-serif; font-size: 1=
3px;"><div><div dir=3D"ltr" data-setdir=3D"false">My experience -- old docs=
are for museums. Quite often, the documented function name has been =
changed a few releases ago, and much after the original implementation.In s=
earching for the function explanation, obsolete information turns up to con=
fuse the reader.</div><div dir=3D"ltr" data-setdir=3D"false">Perhaps too, a=
release date should be attached to each topic.<br></div><div dir=3D"ltr" d=
ata-setdir=3D"false"><br><div dir=3D"ltr" data-setdir=3D"false"><div>I like=
the idea of having 3 generations of docs, some paragraph that says destroy=
by yyyy.mm.dd.</div><br></div></div><div><br></div><div class=3D"ydp549e35=
51signature"><div><div><div><div><div><div><div><span lang=3D"FR-CA">Regard=
s</span> <div><b><font size=3D"2"><br></font><font size=3D"2"> Leslie=
</font><br></b></div> <div><font color=3D"green"><b><font size=3D"1">Leslie=
Satenstein</font></b></font><font style=3D"color:rgb(191, 0, 95);" size=3D=
"1" color=3D"green"><span style=3D"font-weight:bold;"></span></font><br></d=
iv><font size=3D"2" color=3D"green"><b>Montr=C3=A9al Qu=C3=A9bec, Canada</b=
><br></font><br><font size=3D"1" face=3D"lucida console, sans-serif"><b id=
=3D"ydp549e3551yui_3_13_0_ym1_1_1391351152837_28311"><font id=3D"ydp549e355=
1yui_3_13_0_ym1_1_1391351152837_28310" color=3D"black"><span id=3D"ydp549e3=
551yui_3_13_0_ym1_1_1391351152837_28309" style=3D"font-weight:bold;font-siz=
e:13.5pt;color:black;"></span></font></b></font></div></div></div></div></d=
iv></div></div></div></div>
<div><br></div><div><br></div>
=20
</div><div id=3D"ydpc6a3f0abyahoo_quoted_8227382315" class=3D"ydpc6=
a3f0abyahoo_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 p.m. EST, Matthe=
w 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 " rel=3D"nofollow" target=3D"_blank">https://p=
agure.io/fedora-docs/docs-fp-o/issue/118 </a>to not split the<br clear=3D"n=
one">> discussion.<br clear=3D"none"><br clear=3D"none">Proposed path fo=
rward: <a shape=3D"rect" href=3D"https://pagure.io/fedora-docs/docs-fp-o/is=
sue/183" rel=3D"nofollow" target=3D"_blank">https://pagure.io/fedora-docs/d=
ocs-fp-o/issue/183</a><div class=3D"ydpc6a3f0abyqt1670315059" id=3D"ydpc6a3=
f0abyqtfd11283"><br clear=3D"none"><br clear=3D"none"><br clear=3D"none">--=
<br clear=3D"none">Matthew Miller<br clear=3D"none"><<a shape=3D"rect" =
href=3D"mailto:[email protected]" rel=3D"nofollow" target=3D"_blank"=
>[email protected]</a>><br clear=3D"none">Fedora Project Leader<b=
r clear=3D"none">_______________________________________________<br clear=
=3D"none">docs mailing list -- <a shape=3D"rect" href=3D"mailto:docs@lists.=
fedoraproject.org" rel=3D"nofollow" target=3D"_blank">[email protected]=
ect.org</a><br clear=3D"none">To unsubscribe send an email to <a shape=3D"r=
ect" href=3D"mailto:[email protected]" rel=3D"nofollow" ta=
rget=3D"_blank">[email protected]</a><br clear=3D"none">Fe=
dora Code of Conduct: <a shape=3D"rect" href=3D"https://docs.fedoraproject.=
org/en-US/project/code-of-conduct/" rel=3D"nofollow" target=3D"_blank">http=
s://docs.fedoraproject.org/en-US/project/code-of-conduct/</a><br clear=3D"n=
one">List Guidelines: <a shape=3D"rect" href=3D"https://fedoraproject.org/w=
iki/Mailing_list_guidelines" rel=3D"nofollow" target=3D"_blank">https://fed=
oraproject.org/wiki/Mailing_list_guidelines</a><br clear=3D"none">List Arch=
ives: <a shape=3D"rect" href=3D"https://lists.fedoraproject.org/archives/li=
st/[email protected]" rel=3D"nofollow" target=3D"_blank">https:/=
/lists.fedoraproject.org/archives/list/[email protected]</a><br =
clear=3D"none">Do not reply to spam on the list, report it: <a shape=3D"rec=
t" href=3D"https://pagure.io/fedora-infrastructure" rel=3D"nofollow" target=
=3D"_blank">https://pagure.io/fedora-infrastructure</a><br clear=3D"none"><=
/div></div>
</div>
</div></body></html>
------=_Part_5940861_379990589.1638051019042--
--===============5869599298234332738==
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
--===============5869599298234332738==--