Skip site navigation (1)Skip section navigation (2)
Date:      Sat, 28 Jul 2012 13:08:45 -0400
From:      Glen Barber <gjb@glenbarber.us>
To:        "Simon L. B. Nielsen" <simon@FreeBSD.org>,Glen Barber <gjb@FreeBSD.org>
Cc:        webmaster@freebsd.org, FreeBSD Documentation Masters <doceng@FreeBSD.org>, World Wide Web Owner <www@FreeBSD.org>
Subject:   Re: Removal of old/outdated files from www.FreeBSD.org site
Message-ID:  <40854dbc-f4c1-4609-9f48-791a1886c0c9@email.android.com>
In-Reply-To: <9B7CD8B1-42CB-487D-9C27-C9F6D39CD600@FreeBSD.org>
References:  <20120728041732.GH1485@glenbarber.us> <9B7CD8B1-42CB-487D-9C27-C9F6D39CD600@FreeBSD.org>

next in thread | previous in thread | raw e-mail | index | archive | help
"Simon L. B. Nielsen" <simon@FreeBSD.org> wrote:

>[Adding www@ so more people will see and we can wait a bit with the
>next time this comes up :) ]
>

Thank you.

>On 28 Jul 2012, at 05:17, Glen Barber wrote:
>
>[Stale files]
>
>> http://www.freebsd.org/doc/en/books/porters-handbook/x5798.html
>> http://www.freebsd.org/doc/en/books/porters-handbook/x5802.html
>> http://www.freebsd.org/doc/en/books/porters-handbook/x5834.html
>> 
>> If someone from clusteradm@ (or someone else with access to the
>machine
>> on which the documentation build output exists) can remove these old
>> files so they are not archived by search engines (since in some
>cases,
>> old file names can indicate very old files, and worse, very old
>> information that could be potentially dangerous to a user looking for
>> specific information), I would greatly appreciate it.
>
>The problem is that it's not a simple thing to do. Our build installs
>with the option to not install if files are identical, so timestamps
>can't be used alone.
>

Ah, I did forget about that.

>E.g.
>http://www.freebsd.org/doc/en/books/porters-handbook/TRADEMARKS.html :
>
>-r--r--r--  1 www  wwwadm  4494 Jan  9  2010 TRADEMARKS.html
>
>I have removed the mentioned files but I don't have time to do a full
>sweep as I might end up deleting too much.
>

Ok, thank you.  My big concern is if someone "accidentally" finds an old document and does something potentially dangerous to their system.

>> Furthermore, if someone with the appropriate access can provide a
>list
>> of similarly-named files (which also likely can be fixed with adding
>a
>> section id to the source), I will personally fix the section id so
>these
>> files do not occur again.  (It would be even more helpful if the
>files
>> could be provided as an attachment so I can view the source to track
>> down from where they are being generated.)
>
>There is no need for special access to do that. Just build all the docs
>in html-split and find xNNNN.html files. It's a regular thing which has
>to be done as people forget when adding new content. I also remember
>hunting down those files when I more active in doc.
>

I will look into this for a permanent solution then.  It is difficult to spot unless local changes are made though.  But, 'make clean' followed by 'svn stat' will reveal these edge cases.

>I just looked at porters-handboot and it seems there is at least one
>left:
>
>-r--r--r--   1 www  wwwadm    2917 Jul 26 13:31 x5834.html
>

Yes, this should be fixed now.  This is the section ID I added yesterday.

><h1 class="SECT1"><a id="AEN5834" name="AEN5834">6.26 Ports That Rely
>on Kernel
>Sources</a></h1>
>

Anyway, thanks for looking into it.

Glen


-- 
Sent from my Android phone with K-9 Mail. Please excuse my brevity.



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?40854dbc-f4c1-4609-9f48-791a1886c0c9>