docs: fix readme

---
type: pre_commit_static_analysis_report
description: Results of running static analysis checks when committing changes.
report:
  - task: lint_filenames
    status: passed
  - task: lint_editorconfig
    status: passed
  - task: lint_markdown_pkg_readmes
    status: passed
  - task: lint_markdown_docs
    status: na
  - task: lint_markdown
    status: na
  - task: lint_package_json
    status: na
  - task: lint_repl_help
    status: na
  - task: lint_javascript_src
    status: na
  - task: lint_javascript_cli
    status: na
  - task: lint_javascript_examples
    status: na
  - task: lint_javascript_tests
    status: na
  - task: lint_javascript_benchmarks
    status: na
  - task: lint_python
    status: na
  - task: lint_r
    status: na
  - task: lint_c_src
    status: na
  - task: lint_c_examples
    status: na
  - task: lint_c_benchmarks
    status: na
  - task: lint_c_tests_fixtures
    status: na
  - task: lint_shell
    status: na
  - task: lint_typescript_declarations
    status: passed
  - task: lint_typescript_tests
    status: na
  - task: lint_license_headers
    status: passed
---

Author: headlessNode

lib/node_modules/@stdlib/ndarray/base/permute-dimensions/README.md

@@ -42,7 +42,7 @@ var permuteDimensions = require( '@stdlib/ndarray/base/permute-dimensions' );
 
 #### permuteDimensions( x, dims, writable )
 
-Permutes the dimensions of an input ndarray.
+Permutes the dimensions of an input ndarray according to specified dimension indices.
 
 ```javascript
 var getData = require( '@stdlib/ndarray/data-buffer' );
@@ -74,10 +74,10 @@ The function accepts the following arguments:
 
 ## Notes
 
--   The returned ndarray is a **view** of the input ndarray. Accordingly, writing to the original ndarray will **mutate** the returned ndarray and vice versa.
+-   The `writable` parameter **only** applies to ndarray constructors supporting **read-only** instances.
 -   Each dimension index must be unique and fall within the interval `[-ndims, ndims-1]`, where `ndims` is the number of dimensions in the input ndarray.
 -   Operating on views with permuted dimensions can result in performance degradation due to poor cache locality, especially for reductions and operations performed over one or more dimensions on larger arrays.
--   The `writable` parameter **only** applies to ndarray constructors supporting **read-only** instances.
+-   The returned ndarray is a **view** of the input ndarray. Accordingly, writing to the original ndarray will **mutate** the returned ndarray and vice versa.
 
 </section>
 
@@ -94,8 +94,8 @@ The function accepts the following arguments:
 <!-- eslint no-undef: "error" -->
 
 ```javascript
-var ndarray2array = require( '@stdlib/ndarray/to-array' );
 var uniform = require( '@stdlib/random/uniform' );
+var ndarray2array = require( '@stdlib/ndarray/to-array' );
 var permuteDimensions = require( '@stdlib/ndarray/base/permute-dimensions' );
 
 // Create a random array: