Appendix pages are not showing up

[karenzone]

Describe the bug

Logstash uses an appendix to house deleted pages.
These pages are not indexed, but provide a place to land if a user has a link (from forums, user groups, etc). If we have alternatives to offer to a feature we've removed, we owe it to our users to let them know.

Note: After a quick search in the logstash.md source files, it looks like these pages might not have been output. Tagging as a possible migration-tooling issue.

Expected behavior

Keep the appendix with deleted pages, or find a way to preserve the user information experience using a different approach.
Here's an example from classic doc set: https://www.elastic.co/guide/en/logstash/current/plugins-filters-multiline.html

Steps to reproduce

1. Build the logstash.md doc set
2. Go to http://localhost:3000/releasenotes.html and you're at the end of the content set.

Tooling

• docs-builder
• migration tooling
• I'm not sure

[bmorelli25]

I've always understood the appendix pages to be temporary pages that can be used to keep the docs build happy while we wait for redirects to be implemented.

You're not seeing appendix pages because we decided not to bring deleted pages into V3 and instead fully rely on redirects when content moves. I believe redirects provide a better user experience, as there is no middle-ground page that a user has to click through to get to the content they want to see.

[colleenmcginnis]

In the inventory, I've found quite a few Appendix pages that are "real" pages. Happy to share more specifics if that would be helpful.

[karenzone]

Here's an example where we use the appendix to maintain live links when we can still offer users a path forward:
https://www.elastic.co/guide/en/logstash/master/logstash-modules.html

For example, ArcSight module users can check out the Common Event Format (CEF) integration. Azure module users can check out the Azure Logstash integration.

I like this approach because it gives our users a path forward and keeps them engaged with our products.

[bmorelli25]

Is there any differentiation in the headings of deleted pages vs appendix pages? If not, the only feasible way to move this content over is to add it to the nav in the asciidoc books prior to migration.