[lldb] Add a "design" section to the documentation.

[JDevlieghere]

Summary

Create a "Design" section for the LLDB documentation. The goal would be to have design documents that describe how the LLDB internals work. Currently they're mixed together under the "Development" section which hurts discoverability and makes it harder to understand where a new page should go. The existing pages describing the reproducers, the structured data plugins, and the SB API could be housed here but I'd love to see more pages being added here in the future.

[aprantl]

What's the difference between design/ and architecture/? These sounds like synonyms to me.

[jingham]

LGTM

[JDevlieghere]

In D88516#2307486, @aprantl wrote:

What's the difference between design/ and architecture/? These sounds like synonyms to me.

Good point, that page should be moved under the new section as well. Maybe we should call the section "Architecture" and rename that page to "Overview" when nested underneath?

[jingham]

Ah, Adrian is right, you should probably move Architecture to Design.

[jingham]

I like the name Design better than Architecture for the top level. For instance the structureddataplugins is not really Architecture, it's the design of a fairly small component of lldb

[jingham]

Architecture is more specific to the structural aspect of a thing, whereas Design is more general. For instance, the rules for the SB API don’t really seem like a description of an Architecture, but more some general principles for doing the thing.

Jim

[JDevlieghere]

Move architecture under design and rename the page to overview.

lldb/docs/.htaccess

+# Old website redirects
 Redirect 301 /architecture/index.html https://lldb.llvm.org/resources/architecture.html
 Redirect 301 /cpp_reference/html/index.html https://lldb.llvm.org/cpp_reference/index.html
 Redirect 301 /features.html https://lldb.llvm.org/status/features.html
 Redirect 301 /formats.html https://lldb.llvm.org/use/formatting.html
 Redirect 301 /goals.html https://lldb.llvm.org/status/goals.html
 Redirect 301 /lldb-gdb.html https://lldb.llvm.org/use/map.html
 Redirect 301 /projects.html https://lldb.llvm.org/status/projects.html
 Redirect 301 /remote.html https://lldb.llvm.org/use/remote.html
 Redirect 301 /source.html https://lldb.llvm.org/resources/contributing.html
 Redirect 301 /tutorial.html https://lldb.llvm.org/use/tutorial.html
 Redirect 301 /varformats.html https://lldb.llvm.org/use/variable.html
 
-# Sphinx redirects
+# Current website redirects
 Redirect 301 /resources/source.html https://lldb.llvm.org/resources/contributing.html
 Redirect 301 /resources/download.html https://lldb.llvm.org/status/releases.html
 Redirect 301 /use/architecture.html https://lldb.llvm.org/resources/architecture.html
+Redirect 301 /resources/architecture.html https://lldb.llvm.org/design/overview.html
+Redirect 301 /resources/reproducers.html https://lldb.llvm.org/design/reproducers.html
+Redirect 301 /resources/sbapi.html https://lldb.llvm.org/design/sbapi.html

lldb/docs/design/overview.rst

-Architecture
-============
+Overview
+========
 
 LLDB is a large and complex codebase. This section will help you become more
 familiar with the pieces that make up LLDB and give a general overview of the
 general architecture.
 
 LLDB has many code groupings that makeup the source base:
 
 .. contents::

lldb/docs/design/sbapi.rst

-The SB API Coding Rules
-=======================
+Scripting Bridge API
+====================
 
 The SB APIs constitute the stable C++ API that lldb presents to external
 clients, and which get processed by SWIG to produce the Python bindings to
 lldb. As such it is important that they not suffer from the binary
 incompatibilities that C++ is so susceptible to. We've established a few rules
 to ensure that this happens.
 
 The classes in the SB API's are all called SB<SomeName>, where SomeName is in

lldb/docs/index.rst

.. toctree::
    use/remote
    use/troubleshooting
 
 .. toctree::
    :hidden:
    :maxdepth: 1
    :caption: Development
 
-   resources/architecture
    resources/contributing
    resources/build
    resources/test
    resources/bots
-   resources/reproducers
-   resources/structureddataplugins
-   resources/sbapi
    resources/caveats
 
+
+.. toctree::
+   :hidden:
+   :maxdepth: 1
+   :caption: Design
+
+   design/overview
+   design/reproducers
+   design/structureddataplugins
+   design/sbapi
+
 .. toctree::
    :hidden:
    :maxdepth: 1
    :caption: Reference
 
    Public Python API <https://lldb.llvm.org/python_reference/index.html>
    Public C++ API <https://lldb.llvm.org/cpp_reference/namespacelldb.html>
    Private C++ API <https://lldb.llvm.org/cpp_reference/index.html>