Date: Wed, 01 Aug 2012 05:05:12 -0300 From: H <hm@hm.net.br> To: Aristedes Maniatis <ari@ish.com.au> Cc: freebsd-stable <freebsd-stable@freebsd.org> Subject: Re: release documentation confusing for 9.1 Message-ID: <5018E338.80506@hm.net.br> In-Reply-To: <50187DEB.2090906@ish.com.au> References: <50187DEB.2090906@ish.com.au>
next in thread | previous in thread | raw e-mail | index | archive | help
This is an OpenPGP/MIME signed message (RFC 2440 and 3156) --------------enig4176FA4332A8D6B88869D012 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: quoted-printable Aristedes Maniatis wrote: > Could I ask that someone with appropriate access rights review the stat= e > of release documentation for 9.1 beta. It is very confused. >=20 >=20 > 1. This page is the best information available: > http://www.freebsd.org/releases/9.1R/schedule.html >=20 > 2. The link from the front page ( http://www.freebsd.org/ ) is labelled= > "Upcoming: 9.1-BETA1" but goes to a page which is mostly about existing= > releases, not the next release. http://www.freebsd.org/where.html#helpt= est >=20 > 3. Clicking on the "view" link for the 9.1 information on that page > takes you to http://wiki.freebsd.org/Releng/9.1TODO which looks a lot > like the information in point [1] but wrong/old. >=20 > 4. On http://www.freebsd.org/where.html#helptest there is a link to > "FreeBSD Snapshot Releases" for people interested in "FreeBSD-CURRENT > (AKA 10.0-CURRENT)". But following the link takes you to a page where > you get linked to "9-CURRENT, 8-STABLE, 7-STABLE, and 6-STABLE" snapsho= ts. >=20 >=20 >=20 > It is possible I'm just stuck in the past, but I've never been able to > navigate the 'new' bowling ball branded FreeBSD site nearly as well as > the older incarnation. And yes, I can eventually figure it all out... > but this information could be a whole lot clearer. I design information= > presentation for a living, so perhaps I'm picky about these things, but= > I do think that confusion could turn people away from my favourite > operating system. >=20 Hi I can not agree more about what you say, but the pages you mention still let you find what you want and this pages do have a release/modify date stamp somewhere and they are not thaaat old worse and worse it gets when looking for documentation all this pages do not have a date or indication to what version they refer to, most are old, some even wrong for actual releases even if recognizing the work spent by all to write the pages, also recognizing that all docs are well written, organized and understandable, all of it is worthless when not up to date, wrong or incomplete for actual releases (either OS or ports) or merely theoretical= this is still more important because a lot of general product docs for, lets say for example xorg or kde, do not apply fully to their FreeBSD ports, forcing the user finding his way elsewhere or getting stuck with eventually not working system or as you say leading to turn away from freeBSD one step forward would be, adding at least the last modified date to each document, but not in tiny light grey chars at the bottom, but big and fat on top of the doc, so at last the user would have the possibility to consider it being old or new documentation []s Hans --=20 H +55 11 4249.2222 --------------enig4176FA4332A8D6B88869D012 Content-Type: application/pgp-signature; name="signature.asc" Content-Description: OpenPGP digital signature Content-Disposition: attachment; filename="signature.asc" -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.19 (FreeBSD) iEYEARECAAYFAlAY40kACgkQvKVfg5xjCDztkwCcDLWZhqHW18yBVgamo3e4p53c 9rAAnj6QdC7hq2NcHPs8y0O4Wks12OS6 =JZdi -----END PGP SIGNATURE----- --------------enig4176FA4332A8D6B88869D012--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?5018E338.80506>