Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Incomplete documentation in Jetty 12 #12587

Open
lachlan-roberts opened this issue Nov 27, 2024 · 0 comments
Open

Incomplete documentation in Jetty 12 #12587

lachlan-roberts opened this issue Nov 27, 2024 · 0 comments

Comments

@lachlan-roberts
Copy link
Contributor

In the Jetty 10 branch there was the directory documentation/jetty-documentation/src/main/asciidoc/old_docs which contains the documentation which was never ported to the new documentation style, and because of this was never imported to Jetty 12.

All this has since been removed by 576b7d7.

However many of the files in this section contained good information which has now been entirely deleted.

I think we need to fully review this deleted documentation because many of the files/content should be restored or integrated the Jetty 12 documentation.

This is some examples of some of the content in these sections which have been deleted and not present in Jetty 12 docs. Some of these could now be irrelevant or need to be completely updated, but I think there is a lot of useful content in here that has been lost.

  • ALPN
  • temporary-directories
  • setting-form-size
  • custom-error-pages
  • debugging-with-eclipse
  • debugging-with-intellij
  • deployment-architecture
  • deployment-processing-webapps
  • extras
    • balancer-servlet.adoc
    • cgi-servlet.adoc
    • chapter.adoc
    • cross-origin-filter.adoc
    • debug-handler.adoc
    • default-handler.adoc
    • default-servlet.adoc
    • dos-filter.adoc
    • error-handler.adoc
    • gzip-filter.adoc
    • header-filter.adoc
    • inetaccess-handler.adoc
    • ipaccess-handler.adoc
    • moved-context-handler.adoc
    • proxy-servlet.adoc
    • qos-filter.adoc
    • resource-handler.adoc
    • rewrite-handler.adoc
    • shutdown-handler.adoc
    • statistics-handler.adoc
  • frameworks
    • cdi.adoc
    • chapter.adoc
    • metro.adoc
    • osgi.adoc
  • gettingstarted/*
  • jetty-xml
    • jetty-web.xml
    • webdefault.xml
    • jetty.xml file
  • jetty-runner.adoc
  • security
    • authentication.adoc
    • chapter.adoc
    • configuring-form-size.adoc
    • jaas-support.adoc
    • jetty-home-and-jetty-base.adoc
    • openid-support.adoc
    • secure-passwords.adoc
    • serving-aliased-files.adoc
    • setting-port80-access-for-non-root-user.adoc
    • spnego-support.adoc
  • startup
    • startup-unix-service.adoc
    • startup-windows-service.adoc
  • troubleshooting
    • preventing-memory-leaks.adoc
    • security-reports.adoc
    • slow-deployment.adoc
    • troubleshooting-locked-files.adoc
    • troubleshooting-zip-exceptions.adoc
    • watchservice.adoc
  • tuning
    • garbage-collection.adoc
    • high-load.adoc
    • limit-load.adoc

There is also many TODO's in the current docs including.

  • troubleshooting-introduction
  • jvm-thread-dump
  • Configuring init-params
  • FastCGI Server Libraries
  • various TODOs in server/http.adoc
  • various TODOs in client/http.adoc
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

1 participant