Review NGINX Plus Deployment Guide: F5 big IP config

[mjang]

This page, https://docs.nginx.com/nginx/deployment-guides/migrate-hardware-adc/f5-big-ip-configuration/, is somewhat "difficult" to read. (Flesch-Kincaid estimate: 12.33)

You can review and edit the source code for the page directly in our repository. You can edit it directly, as described in Editing files.

Alternatively, If you know Git, you're welcome to fork the repository and use your skills to set up a Pull request.

We need to audit this page.

Here's what we'd like you to do (tasks):

• Audit screenshots

  • Update if they're out of date
  • Evaluate the screenshots:
    • Do they include too much info, such as Personally Identifying Information
    • Do we need all the information in the screenshot
    • Do we even need the screenshot, since it's from "someone else's" UI
      • If you propose removing the screenshot, include replacement text (if/as required)

• Evaluate the page for readability

  • Use the process described in Good first issues for writers -- focused on readability #72
  • Update the content of the page

If you're not (yet) comfortable with Git, you're welcome to post your answers to this issue in a Discussion.

• We'll be happy to give you credit!

If you haven't been able to do everything in this issue, that's OK. We appreciate all the help that we can get.

[rlstern]

Please assign this to me

[rlstern]

I attempted to increase the readability of the beginning explanation by simplifying sentences, but this will require review by a technical expert, as the meanings could have changed over the course of simplifying. In some cases, the pronoun in the sentence was indirect, so review is needed to determine the proper noun to which it refers. In these cases, I have bolded where clarity is needed. I also bolded one instance of an undefined acronym.

Readability Improvement Draft - F5 big IP config.docx

No changes were made past the section “Definitions of Networking Concepts“.

Note - none of the images were audited.

[mjang]

@rlstern thanks so much for your work! Your doc file is a permanent part of this issue.

If you'd like to take this further, you could use the steps described in this issue to start suggesting changes to our current documentation.

Alternatively, you could:

• Navigate to the webpage for the doc: https://docs.nginx.com/nginx/deployment-guides/migrate-hardware-adc/f5-big-ip-configuration/
• Scroll to near the bottom of the page
• Click "Edit this page"

If you want to take "the next step," I'll be happy to help you with details and any questions you may have about the process. Thanks!