All of lore.kernel.org
 help / color / mirror / Atom feed
From: Olof Johansson <olof@lixom.net>
To: Linus Torvalds <torvalds@linux-foundation.org>
Cc: James Bottomley <James.Bottomley@hansenpartnership.com>,
	Greg Kroah-Hartman <gregkh@linuxfoundation.org>,
	tech-board-discuss@lists.linuxfoundation.org
Subject: Re: [Tech-board-discuss] [PATCH] CodingStyle: Inclusive Terminology
Date: Mon, 6 Jul 2020 19:05:39 -0700	[thread overview]
Message-ID: <CAOesGMi_byg0i1-iT5asj29f7PEjA5Oco=mU4Kmtrd3e4MfhqA@mail.gmail.com> (raw)
In-Reply-To: <CAHk-=whJYFgbjPqp8XMTyX7ic2x_N3coHc-5fFHV27PuNJRBdw@mail.gmail.com>

On Sat, Jul 4, 2020 at 5:00 PM Linus Torvalds
<torvalds@linux-foundation.org> wrote:
>
> On Sat, Jul 4, 2020 at 2:25 PM James Bottomley
> <James.Bottomley@hansenpartnership.com> wrote:
> >
> > Could we just lose this entire document?
>
> I have to agree. I see no value to it except as a source of heated
> discussion and non-productive flame wars.

I think it has 2-3 purposes:

1) To motivate the change.
2) To have one place to point people at when new, often not active
community participants, chime in with more "what about" questions,
instead of having the same discussions over and over.
2b) Paragraph 5, and see below for more about that.

For changes to code, we sort of have one/two good places to document
why a change is introduced already:

1) For patches, the patch description. It'll live forever in the git history.
2) For branches, the merge commit. Useful in particular to document
any comments when merging code by a maintainer, but also as an
overview if there's a bunch of patches in the branch.

So, would it make sense to rework the contents and include it in the
patch description instead? Still easy to point people at in the git
history, and maybe a bit less of a sore spot.

> We can't start denying colours. What's next? Yellow and red and brown
> not being acceptable either?
>
> Red-black trees really must be the worst kinds of data structures,
> because in addition to the dangerous color mentions, the "trees" they
> talk about might be all about the historical lynchings of
> african-americans and native americans?
>
> Which I obviously bring up entirely because it's an example of just
> stupid things to argue about, rather than anything productive.
> Obviously rbtrees are nothing of the sort, and anybody who thinks they
> are should simply not be doing kernel development.
>
> At some point, maybe we should admit that we are inclusive, but also
> just admit that we don't want to have the kinds of people who instead
> of doing kernel development, waste everybody's time with talking about
> the meaning of the word "black".

I think there's a difference between listening to the community
members that are affected by this, considering their proposals such as
Dan's in this case, and debating this with random people on the
internet.

Dan's 5th paragraph in the file actually applies quite well to the
current discussion:

"Of course it is around this point someone jumps in with an
etymological argument about why people should not be offended.
Etymological arguments do not scale. The scope and pace of Linux to
reach new developers exceeds the ability of historical terminology
defenders to describe "no, not that connotation".  [...]"

I also don't think we're going to be able to leave all of this behind
us with or without the file with the motivation being merged. I
personally see more benefit than drawback of including it, especially
for paragraph 5 since that will come up over and over again.


-Olof

  parent reply	other threads:[~2020-07-07  2:05 UTC|newest]

Thread overview: 281+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2020-07-04 20:02 [Ksummit-discuss] [PATCH] CodingStyle: Inclusive Terminology Dan Williams
2020-07-04 20:02 ` [Tech-board-discuss] " Dan Williams
2020-07-04 20:02 ` Dan Williams
2020-07-04 20:31 ` [Ksummit-discuss] " Randy Dunlap
2020-07-04 20:31   ` [Tech-board-discuss] " Randy Dunlap
2020-07-04 20:31   ` Randy Dunlap
2020-07-04 23:41   ` [Ksummit-discuss] " Dave Airlie
2020-07-04 23:41     ` [Tech-board-discuss] " Dave Airlie
2020-07-04 23:41     ` Dave Airlie
2020-07-05  0:10     ` Matthew Wilcox
2020-07-05  0:10       ` [Tech-board-discuss] " Matthew Wilcox
2020-07-05  1:10       ` [Ksummit-discuss] [Tech-board-discuss] " Kees Cook
2020-07-05  1:10         ` [Tech-board-discuss] [Ksummit-discuss] " Kees Cook
2020-07-05  1:10         ` Kees Cook
2020-07-05  2:44         ` [Ksummit-discuss] [Tech-board-discuss] " Randy Dunlap
2020-07-05  2:44           ` [Tech-board-discuss] [Ksummit-discuss] " Randy Dunlap
2020-07-05  2:44           ` Randy Dunlap
2020-07-06 11:15         ` [Ksummit-discuss] [Tech-board-discuss] " Michael Kerrisk (man-pages)
2020-07-06 11:15           ` [Tech-board-discuss] [Ksummit-discuss] " Michael Kerrisk (man-pages)
2020-07-06 11:15           ` [Ksummit-discuss] [Tech-board-discuss] " Michael Kerrisk (man-pages)
2020-07-06 15:53           ` Kees Cook
2020-07-06 15:53             ` [Tech-board-discuss] [Ksummit-discuss] " Kees Cook
2020-07-06 15:53             ` [Ksummit-discuss] [Tech-board-discuss] " Kees Cook
2020-07-05  2:54       ` [Ksummit-discuss] " Dave Airlie
2020-07-05  2:54         ` [Tech-board-discuss] " Dave Airlie
2020-07-05  2:54         ` Dave Airlie
2020-07-04 20:44 ` Stephen Rothwell
2020-07-04 20:44   ` [Tech-board-discuss] " Stephen Rothwell
2020-07-04 20:44   ` Stephen Rothwell
2020-07-04 23:34   ` Dave Airlie
2020-07-04 23:34     ` [Tech-board-discuss] " Dave Airlie
2020-07-04 23:34     ` Dave Airlie
2020-07-05  2:12     ` Stephen Rothwell
2020-07-05  2:12       ` [Tech-board-discuss] " Stephen Rothwell
2020-07-05  2:12       ` Stephen Rothwell
2020-07-05  2:56       ` Dave Airlie
2020-07-05  2:56         ` [Tech-board-discuss] " Dave Airlie
2020-07-05  2:56         ` Dave Airlie
2020-07-05  3:23         ` James Bottomley
2020-07-05  3:23           ` [Tech-board-discuss] " James Bottomley
2020-07-05  3:23           ` James Bottomley
2020-07-05  3:26         ` Stephen Rothwell
2020-07-05  3:26           ` [Tech-board-discuss] " Stephen Rothwell
2020-07-05  3:26           ` Stephen Rothwell
2020-07-04 21:14 ` Olof Johansson
2020-07-04 21:14   ` [Tech-board-discuss] " Olof Johansson
2020-07-04 21:14   ` Olof Johansson
2020-07-04 21:25 ` [Ksummit-discuss] [Tech-board-discuss] " James Bottomley
2020-07-04 21:25   ` James Bottomley
2020-07-04 21:25   ` James Bottomley
2020-07-04 21:51   ` [Ksummit-discuss] " Joe Perches
2020-07-04 21:51     ` Joe Perches
2020-07-04 21:51     ` Joe Perches
2020-07-04 22:19   ` Linus Torvalds
2020-07-05 11:59     ` Laura Abbott
2020-07-05 16:39       ` James Bottomley
2020-07-05 17:21     ` Chris Mason
2020-07-05 20:26       ` Kees Cook
2020-07-07  2:05     ` Olof Johansson [this message]
2020-07-07  2:52       ` James Bottomley
2020-07-07  3:33         ` Dan Williams
2020-07-04 23:39   ` [Ksummit-discuss] " Dave Airlie
2020-07-04 23:39     ` [Tech-board-discuss] [Ksummit-discuss] " Dave Airlie
2020-07-04 23:39     ` [Ksummit-discuss] [Tech-board-discuss] " Dave Airlie
2020-07-05  0:08     ` Joe Perches
2020-07-05  0:08       ` [Tech-board-discuss] [Ksummit-discuss] " Joe Perches
2020-07-05  0:08       ` [Ksummit-discuss] [Tech-board-discuss] " Joe Perches
2020-07-05  1:32     ` Kees Cook
2020-07-05  1:32       ` [Tech-board-discuss] [Ksummit-discuss] " Kees Cook
2020-07-05  1:32       ` [Ksummit-discuss] [Tech-board-discuss] " Kees Cook
2020-07-05 17:50     ` opal hart
2020-07-05 17:50       ` [Tech-board-discuss] [Ksummit-discuss] " opal hart
2020-07-05 17:50       ` [Ksummit-discuss] [Tech-board-discuss] " opal hart
2020-07-04 23:42 ` [Ksummit-discuss] " Dave Airlie
2020-07-04 23:42   ` [Tech-board-discuss] " Dave Airlie
2020-07-04 23:42   ` Dave Airlie
2020-07-05  0:12 ` Matthew Wilcox
2020-07-05  0:12   ` [Tech-board-discuss] " Matthew Wilcox
2020-07-06  7:06   ` NeilBrown
2020-07-06  7:06     ` [Tech-board-discuss] " NeilBrown
2020-07-06  7:06     ` NeilBrown
2020-07-06  7:10   ` NeilBrown
2020-07-06  7:10     ` [Tech-board-discuss] " NeilBrown
2020-07-06  7:10     ` NeilBrown
2020-07-06  7:22     ` Greg Kroah-Hartman
2020-07-06  7:22       ` [Tech-board-discuss] " Greg Kroah-Hartman
2020-07-06  7:22       ` Greg Kroah-Hartman
2020-07-06  7:53       ` Geert Uytterhoeven
2020-07-06  7:53         ` [Tech-board-discuss] " Geert Uytterhoeven
2020-07-06  7:53         ` Geert Uytterhoeven
2020-07-06 10:22         ` Greg Kroah-Hartman
2020-07-06 10:22           ` [Tech-board-discuss] " Greg Kroah-Hartman
2020-07-06 10:22           ` Greg Kroah-Hartman
2020-07-06 12:51         ` Matthew Wilcox
2020-07-06 12:51           ` [Tech-board-discuss] " Matthew Wilcox
2020-07-06 12:51           ` Matthew Wilcox
2020-07-06 12:59           ` Joe Perches
2020-07-06 12:59             ` [Tech-board-discuss] " Joe Perches
2020-07-06 12:59             ` Joe Perches
2020-07-06 13:04             ` Matthew Wilcox
2020-07-06 13:04               ` [Tech-board-discuss] " Matthew Wilcox
2020-07-06 13:04               ` Matthew Wilcox
2020-07-06 13:30               ` Joe Perches
2020-07-06 13:30                 ` [Tech-board-discuss] " Joe Perches
2020-07-06 13:30                 ` Joe Perches
2020-07-09 11:11                 ` Mauro Carvalho Chehab
2020-07-09 11:11                   ` [Tech-board-discuss] " Mauro Carvalho Chehab
2020-07-09 11:11                   ` Mauro Carvalho Chehab
2020-07-13  4:25                   ` Vinod Koul
2020-07-13  4:25                     ` [Tech-board-discuss] " Vinod Koul
2020-07-13  4:25                     ` Vinod Koul
2020-07-13 15:55                     ` Dan Williams
2020-07-13 15:55                       ` [Tech-board-discuss] " Dan Williams
2020-07-13 15:55                       ` Dan Williams
2020-07-05  0:41 ` Kees Cook
2020-07-05  0:41   ` [Tech-board-discuss] " Kees Cook
2020-07-05  0:41   ` Kees Cook
2020-07-07  4:30   ` [Ksummit-discuss] " Dan Williams
2020-07-07  4:30     ` [Tech-board-discuss] " Dan Williams
2020-07-07  4:30     ` Dan Williams
2020-07-10 16:52     ` [Ksummit-discuss] " Andy Lutomirski
2020-07-10 16:52       ` [Tech-board-discuss] " Andy Lutomirski
2020-07-10 16:52       ` Andy Lutomirski
2020-07-05  4:55 ` Willy Tarreau
2020-07-05  4:55   ` [Tech-board-discuss] " Willy Tarreau
2020-07-05  4:55   ` Willy Tarreau
2020-07-06  3:13   ` [Ksummit-discuss] " Daniel Palmer
2020-07-06  3:13     ` [Tech-board-discuss] " Daniel Palmer
2020-07-06  3:13     ` Daniel Palmer
2020-07-06 12:45   ` [Ksummit-discuss] " Chris Mason via Ksummit-discuss
2020-07-06 12:45     ` [Tech-board-discuss] " Chris Mason
2020-07-06 12:45     ` Chris Mason
2020-07-06 14:06     ` [Ksummit-discuss] " Laurent Pinchart
2020-07-06 14:06       ` [Tech-board-discuss] " Laurent Pinchart
2020-07-06 14:06       ` Laurent Pinchart
2020-07-06 15:55       ` Chris Mason via Ksummit-discuss
2020-07-06 15:55         ` [Tech-board-discuss] " Chris Mason
2020-07-06 15:55         ` Chris Mason
2020-07-06 16:06     ` Mike Rapoport
2020-07-06 16:06       ` [Tech-board-discuss] " Mike Rapoport
2020-07-06 16:06       ` Mike Rapoport
2020-07-07  4:17       ` Dan Williams
2020-07-07  4:17         ` [Tech-board-discuss] " Dan Williams
2020-07-07  4:17         ` Dan Williams
2020-07-06 15:22   ` Arvind Sankar
2020-07-06 15:22     ` [Tech-board-discuss] " Arvind Sankar
2020-07-06 15:22     ` Arvind Sankar
2020-07-06 15:40     ` [Ksummit-discuss] [Tech-board-discuss] " Steven Rostedt
2020-07-06 15:40       ` Steven Rostedt
2020-07-06 15:40       ` Steven Rostedt
2020-07-06 13:23 ` [Ksummit-discuss] " Tibor Raschko
2020-07-06 13:23   ` Tibor Raschko
2020-07-06 16:29 ` [Ksummit-discuss] " Andy Lutomirski
2020-07-06 16:29   ` [Tech-board-discuss] " Andy Lutomirski
2020-07-06 16:29   ` Andy Lutomirski
2020-07-07  4:00   ` Dan Williams
2020-07-07  4:00     ` [Tech-board-discuss] " Dan Williams
2020-07-07  4:00     ` Dan Williams
2020-07-07  5:56   ` Kees Cook
2020-07-07  5:56     ` [Tech-board-discuss] " Kees Cook
2020-07-07  5:56     ` Kees Cook
2020-07-07  6:49     ` Mike Rapoport
2020-07-07  6:49       ` [Tech-board-discuss] " Mike Rapoport
2020-07-07  6:49       ` Mike Rapoport
2020-07-07 13:37       ` [Ksummit-discuss] [Tech-board-discuss] " Steven Rostedt
2020-07-07 13:37         ` [Tech-board-discuss] [Ksummit-discuss] " Steven Rostedt
2020-07-07 13:37         ` Steven Rostedt
2020-07-07 15:24         ` [Ksummit-discuss] [Tech-board-discuss] " Bird, Tim
2020-07-07 15:24           ` [Tech-board-discuss] [Ksummit-discuss] " Bird, Tim
2020-07-07 15:24           ` [Ksummit-discuss] [Tech-board-discuss] " Bird, Tim
2020-07-07 15:33           ` Randy Dunlap
2020-07-07 15:33             ` [Tech-board-discuss] [Ksummit-discuss] " Randy Dunlap
2020-07-07 15:33             ` [Ksummit-discuss] [Tech-board-discuss] " Randy Dunlap
2020-07-07 15:41             ` Steven Rostedt
2020-07-07 15:41               ` [Tech-board-discuss] [Ksummit-discuss] " Steven Rostedt
2020-07-07 15:41               ` [Ksummit-discuss] [Tech-board-discuss] " Steven Rostedt
2020-07-07 15:55               ` Bird, Tim
2020-07-07 15:55                 ` [Tech-board-discuss] [Ksummit-discuss] " Bird, Tim
2020-07-07 15:55                 ` [Ksummit-discuss] [Tech-board-discuss] " Bird, Tim
2020-07-07  6:56     ` [Ksummit-discuss] " Harrosh, Boaz
2020-07-07  6:56       ` [Tech-board-discuss] " Harrosh, Boaz
2020-07-07  6:56       ` Harrosh, Boaz
2020-07-07  8:54       ` Kees Cook
2020-07-07  8:54         ` [Tech-board-discuss] " Kees Cook
2020-07-07  8:54         ` Kees Cook
2020-07-07 13:41         ` [Ksummit-discuss] [Tech-board-discuss] " Steven Rostedt
2020-07-07 13:41           ` [Tech-board-discuss] [Ksummit-discuss] " Steven Rostedt
2020-07-07 14:45           ` [Ksummit-discuss] [Tech-board-discuss] " Mike Rapoport
2020-07-07 14:45             ` [Tech-board-discuss] [Ksummit-discuss] " Mike Rapoport
2020-07-07 14:45             ` [Ksummit-discuss] [Tech-board-discuss] " Mike Rapoport
2020-07-07 20:56             ` Kees Cook
2020-07-07 20:56               ` [Tech-board-discuss] [Ksummit-discuss] " Kees Cook
2020-07-07 20:56               ` [Ksummit-discuss] [Tech-board-discuss] " Kees Cook
2020-07-07 21:48         ` [Ksummit-discuss] " Arvind Sankar
2020-07-07 21:48           ` [Tech-board-discuss] " Arvind Sankar
2020-07-07 21:48           ` Arvind Sankar
2020-07-07 12:13       ` Mark Brown
2020-07-07 12:13         ` [Tech-board-discuss] " Mark Brown
2020-07-07 12:13         ` Mark Brown
2020-07-06 18:30 ` [Ksummit-discuss] [Tech-board-discuss] " Shuah Khan
2020-07-06 18:30   ` Shuah Khan
2020-07-06 18:30   ` Shuah Khan
2020-07-06 23:58   ` [Ksummit-discuss] " Tibor Raschko
2020-07-06 23:58     ` Tibor Raschko
2020-07-09 10:43     ` [Ksummit-discuss] " Mauro Carvalho Chehab
2020-07-09 10:43       ` [Tech-board-discuss] [Ksummit-discuss] " Mauro Carvalho Chehab
2020-07-09 16:01       ` [Ksummit-discuss] [Tech-board-discuss] " Shuah Khan
2020-07-09 16:01         ` [Tech-board-discuss] [Ksummit-discuss] " Shuah Khan
2020-07-09 16:01         ` [Ksummit-discuss] [Tech-board-discuss] " Shuah Khan
2020-07-09 16:13         ` Mark Brown
2020-07-09 16:13           ` [Tech-board-discuss] [Ksummit-discuss] " Mark Brown
2020-07-09 16:13           ` Mark Brown
2020-07-09 16:32           ` [Ksummit-discuss] [Tech-board-discuss] " James Bottomley
2020-07-09 16:32             ` [Tech-board-discuss] [Ksummit-discuss] " James Bottomley
2020-07-09 16:32             ` [Ksummit-discuss] [Tech-board-discuss] " James Bottomley
2020-07-09 16:35           ` Steven Rostedt
2020-07-09 16:35             ` [Tech-board-discuss] [Ksummit-discuss] " Steven Rostedt
2020-07-09 16:35             ` Steven Rostedt
2020-07-10  9:38         ` [Ksummit-discuss] [Tech-board-discuss] " Tibor Raschko
2020-07-10  9:38           ` [Tech-board-discuss] [Ksummit-discuss] " Tibor Raschko
2020-07-07  4:04   ` [Ksummit-discuss] [Tech-board-discuss] " Dan Williams
2020-07-07  4:04     ` Dan Williams
2020-07-07  4:04     ` Dan Williams
2020-07-06 19:15 ` [Ksummit-discuss] " Mark Brown
2020-07-06 19:15   ` Mark Brown
2020-07-06 19:15   ` Mark Brown
2020-07-07  0:48   ` [Ksummit-discuss] " Tibor Raschko
2020-07-07  0:48     ` Tibor Raschko
2020-07-07  0:48     ` Tibor Raschko
2020-07-07 21:26     ` [Ksummit-discuss] " Arvind Sankar
2020-07-07 21:26       ` Arvind Sankar
2020-07-07 21:26       ` Arvind Sankar
2020-07-07 23:54       ` [Ksummit-discuss] " Tibor Raschko
2020-07-07 23:54         ` Tibor Raschko
2020-07-07 23:54         ` Tibor Raschko
2020-07-07  4:08   ` [Ksummit-discuss] " Dan Williams
2020-07-07  4:08     ` Dan Williams
2020-07-07  4:08     ` Dan Williams
2020-07-07  9:36     ` [Ksummit-discuss] " Mark Brown
2020-07-07  9:36       ` Mark Brown
2020-07-07  9:36       ` Mark Brown
2020-07-06 21:31 ` [Ksummit-discuss] " Pavel Begunkov
2020-07-06 21:31   ` [Tech-board-discuss] " Pavel Begunkov
2020-07-06 21:31   ` Pavel Begunkov
2020-07-06 22:10   ` [Ksummit-discuss] [Tech-board-discuss] " Steven Rostedt
2020-07-06 22:10     ` Steven Rostedt
2020-07-06 22:10     ` Steven Rostedt
2020-07-06 22:17     ` [Ksummit-discuss] " Pavel Begunkov
2020-07-06 22:17       ` Pavel Begunkov
2020-07-06 22:17       ` Pavel Begunkov
2020-07-06 22:28       ` [Ksummit-discuss] " Steven Rostedt
2020-07-06 22:28         ` Steven Rostedt
2020-07-06 22:28         ` Steven Rostedt
2020-07-06 23:03         ` [Ksummit-discuss] " Pavel Begunkov
2020-07-06 23:03           ` Pavel Begunkov
2020-07-06 23:03           ` Pavel Begunkov
2020-07-08  3:42           ` [Ksummit-discuss] " Stephen Hemminger
2020-07-08  3:42             ` [Tech-board-discuss] [Ksummit-discuss] " Stephen Hemminger
2020-07-08  3:42             ` [Ksummit-discuss] [Tech-board-discuss] " Stephen Hemminger
2020-07-08 10:51             ` Pavel Begunkov
2020-07-08 10:51               ` [Tech-board-discuss] [Ksummit-discuss] " Pavel Begunkov
2020-07-07  6:56 ` SeongJae Park via Ksummit-discuss
2020-07-07  6:56   ` [Tech-board-discuss] " SeongJae Park
2020-07-07  6:56   ` SeongJae Park
2020-07-08  7:12   ` Dan Williams
2020-07-08  7:12     ` [Tech-board-discuss] " Dan Williams
2020-07-08  7:12     ` Dan Williams
2020-07-08  9:28     ` SeongJae Park via Ksummit-discuss
2020-07-08  9:28       ` [Tech-board-discuss] " SeongJae Park
2020-07-08  9:28       ` SeongJae Park
2020-07-07  7:51 ` Christian Brauner
2020-07-07  7:51   ` [Tech-board-discuss] " Christian Brauner
2020-07-07  7:51   ` Christian Brauner
2020-07-08 18:40 ` Daniel Vetter
2020-07-08 18:40   ` [Tech-board-discuss] " Daniel Vetter
2020-07-17  8:35 ` Pavel Machek
2020-07-17  8:35   ` [Tech-board-discuss] " Pavel Machek
2020-07-17  8:35   ` Pavel Machek
2020-07-26 15:30 ` [Ksummit-discuss] " Laurent Pinchart
2020-07-26 15:30   ` [Tech-board-discuss] " Laurent Pinchart
2020-07-26 15:30   ` Laurent Pinchart

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to='CAOesGMi_byg0i1-iT5asj29f7PEjA5Oco=mU4Kmtrd3e4MfhqA@mail.gmail.com' \
    --to=olof@lixom.net \
    --cc=James.Bottomley@hansenpartnership.com \
    --cc=gregkh@linuxfoundation.org \
    --cc=tech-board-discuss@lists.linuxfoundation.org \
    --cc=torvalds@linux-foundation.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.