Re: misc/52831: [htdocs] developers:

[Leonardo Taccari <leot%NetBSD.org@localhost>]

The following reply was made to PR misc/52831; it has been noted by GNATS.

From: Leonardo Taccari <leot%NetBSD.org@localhost>
To: gnats-bugs%NetBSD.org@localhost
Cc: 
Subject: Re: misc/52831: [htdocs] developers:
Date: Sun, 17 Dec 2017 15:06:11 +0100

 Hello Eitan,
 
 lists%eitanadler.com@localhost writes:
 > [...]
 > While here, remove other dead links and references.
 > >How-To-Repeat:
 >
 > >Fix:
 > [... omitting the developers/htdocs.html diff ...]
 > Index: developers/htdocs.xml
 > =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
 =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
 =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 > RCS file: /cvsroot/htdocs/developers/htdocs.xml,v
 > retrieving revision 1.54
 > diff -u -r1.54 htdocs.xml
 > --- developers/htdocs.xml	14 Jan 2017 21:35:21 -0000	1.54
 > +++ developers/htdocs.xml	17 Dec 2017 00:27:49 -0000
 > @@ -205,29 +205,6 @@
 >  </para>
 >  </sect3>
 >  =
 
 > -<sect3 id=3D"flaglinks">
 > -<title>What is the reasoning behind the flag links with empty.gif?</tit=
 le>
 > -<para>
 > -    Each NetBSD 'flag' links at the base of each page has:
 > -    <itemizedlist>
 > -    <listitem>href containing netbsd-banner with no alt tag</listitem>
 > -    <listitem>href containing empty gif with "NetBSD" alt tag and the
 > -        words "Home Page"</listitem>
 > -    </itemizedlist>
 > -    This has the effect of:
 > -    <itemizedlist>
 > -    <listitem>Making the "NetBSD Home Page" link a single link in lynx,
 > -	i.e. not a NetBSD link and a Home Page link.</listitem>
 > -    <listitem>In netscape, causing the additional text to be centered a=
 nd
 > -        aligned "better" w.r.t the graphic.  Without it, at least
 > -        in netscape, they show up at the bottom not centered
 > -        vertically, and abut the graphic (or, if you include spaces,
 > -        include nasty underlined blanks which looks broken).</listitem>
 > -    </itemizedlist>
 > -    It's a grotty hack, but it makes things look right.
 > -</para>
 > -</sect3>
 > -
 
 As discussed in the previous reply IMHO it's better to remove only
 the Netscape part (probably not so relevant these days :)) and
 leave the rest because there is still an htdocs/images/empty.gif
 and a lot of non-converted XML web pages still use it.
 
 What do you think?
 
 >    <sect3 id=3D"templates">
 >      <title>XML template files</title>
 >  =
 
 > @@ -349,36 +326,6 @@
 >  <sect2 id=3D"specific">
 >  <title>Adding to specific areas</title>
 >  =
 
 > -<sect3 id=3D"adding-gallery-entries">
 > -<title>Adding to the <quote>Sites running NetBSD</quote> gallery</title=
 >
 > -<para>
 > -If you have a <code>NETBSD GALLERY ADDITION</code> email from the <ulin=
 k
 > -url=3D"../gallery/addsite.html">htdocs/gallery/addsite.html</ulink> pag=
 e:
 > -<orderedlist>
 > -  <listitem>Verify that the remote site has a link back to www.NetBSD.o=
 rg.
 > -    If they do not link back, contact them to ask for a link back and a=
 dd
 > -    the information once the link is provided.</listitem>
 > -  <listitem>Ensure you have perl installed.</listitem>
 > -  <listitem>Save the message in your copy/paste buffer.</listitem>
 > -  <listitem><code>cd htdocs/gallery</code>.</listitem>
 > -  <listitem><code>./addsite.pl</code>, paste the buffer, add a ^D, and =
 answer
 > -      <code>y</code> if it parsed OK.</listitem>
 > -  <listitem><code>cvs commit</code>.</listitem>
 > -</orderedlist>
 > -Alternatively you can manually edit <code>htdocs/gallery/sites.data</co=
 de>, and
 > -run <code>make</code>.
 > -</para>
 > -</sect3>
 > -
 
 Nice catch! It seems that htdocs/gallery/addsite.html was removed
 by <mbalmer> in 2011-07-30.
 
 > -<sect3 id=3D"adding-gallery-screenshots">
 > -<title>Adding to the <quote>NetBSD in action</quote> gallery</title>
 > -<para>
 > -If possible, a screenshot should contain some easily recognizable visua=
 l
 > -indication that it was made on a &os; system. A common way to do this i=
 s
 > -by showing an X terminal that displays the output of <code>uname -a</co=
 de>.
 > -</para>
 > -</sect3>
 > -
 
 Why removing that section? Unfortunately the `NetBSD in Action'
 had accumulated some dust but IMHO we can convert them to an XML page
 and add more screenshots/photographs.
 
 >  <sect3 id=3D"adding-news-items">
 >  <title>Adding News Items</title>
 >  <para>
 > @@ -488,7 +435,7 @@
 >      <ulink url=3D"http://daily.daemonnews.org/add_story.php3";>Daily Dae=
 monnews</ulink>,
 >      <ulink url=3D"http://www.osnews.com/submit.php";>OSNews</ulink>,
 >      <ulink url=3D"http://slashdot.org/submit.pl";>Slashdot</ulink>,
 > -    <ulink url=3D"http://www.newsforge.com/submit.pl";>Newsforge</ulink>=
  and
 > +    and
 >      <ulink url=3D"http://www.bsdforums.org/submitnews.php";>BSDForums</u=
 link>.
 >     </listitem>
 >  </orderedlist>
 >
 
 Whoops, nice catch!