Automatic documentation update

_sources/changelog.md.txt

@@ -14,6 +14,9 @@ should appear here.
     command line.
   - Please see the documentation for a migration guide:
     https://oracle.github.io/yo/guide/region.html#migrating-yo-ini-to-multi-region-support
+- Switched Yo's default setup dialog to use ``oci setup keys``. Updated
+  documentation accordingly.
+
 
 ## 1.6.0 - Wed, Apr 17, 2024
 

_sources/guide/region.md.txt

@@ -47,7 +47,8 @@ environment variable may be overridden by the command line option.
 
 ## Migrating yo.ini to multi-region support
 
-Upon upgrading Yo, you may see the following warning:
+Upon upgrading Yo to version 1.7.0 or later from any prior version, you may see
+the following warning:
 
 ```
 warning: region-specific configurations in [yo] section are deprecated, please update your config to use [regions.*] sections

_sources/install.rst.txt

@@ -50,6 +50,21 @@ but thankfully, this can be easily achieved with the command:
 Follow the prompts to authenticate with your tenancy. If you don't know your
 region, open the OCI Web UI and see what it defaults to.
 
+Please note: if you encounter an error message in the above command which
+contains the code ``NotAuthorizedOrNotFound``, then there's an alternative way
+to setup your OCI credentials:
+
+1. Run ``oci setup keys``. At the prompt, you probably want to type "N/A" to
+   avoid setting a passphrase for the key.
+2. Open the OCI web console. Navigate to your profile using the icon at the top
+   right (or search your email address in the search bar). On your profile page,
+   select the "API keys" link, and then choose "Add API key".
+3. Use "choose public key file" to upload the **public key** generated by step
+   1, and click submit. The resulting page should contain a fragment of
+   configuration file.
+4. Paste the configuration fragment into ``~/.oci/config``. Be sure to set
+   ``key_file`` to the name of your **private** key.
+
 yo Configuration
 ~~~~~~~~~~~~~~~~
 

changelog.html

@@ -50,6 +50,8 @@ <h2>Unreleased<a class="headerlink" href="#unreleased" title="Link to this headi
 https://oracle.github.io/yo/guide/region.html#migrating-yo-ini-to-multi-region-support</p></li>
 </ul>
 </li>
+<li><p>Switched Yo’s default setup dialog to use <code class="docutils literal notranslate"><span class="pre">oci</span> <span class="pre">setup</span> <span class="pre">keys</span></code>. Updated
+documentation accordingly.</p></li>
 </ul>
 </section>
 <section id="wed-apr-17-2024">

guide/region.html

@@ -76,7 +76,8 @@ <h2>Using multiple regions<a class="headerlink" href="#using-multiple-regions" t
 </section>
 <section id="migrating-yo-ini-to-multi-region-support">
 <h2>Migrating yo.ini to multi-region support<a class="headerlink" href="#migrating-yo-ini-to-multi-region-support" title="Link to this heading">¶</a></h2>
-<p>Upon upgrading Yo, you may see the following warning:</p>
+<p>Upon upgrading Yo to version 1.7.0 or later from any prior version, you may see
+the following warning:</p>
 <div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">warning</span><span class="p">:</span> <span class="n">region</span><span class="o">-</span><span class="n">specific</span> <span class="n">configurations</span> <span class="ow">in</span> <span class="p">[</span><span class="n">yo</span><span class="p">]</span> <span class="n">section</span> <span class="n">are</span> <span class="n">deprecated</span><span class="p">,</span> <span class="n">please</span> <span class="n">update</span> <span class="n">your</span> <span class="n">config</span> <span class="n">to</span> <span class="n">use</span> <span class="p">[</span><span class="n">regions</span><span class="o">.*</span><span class="p">]</span> <span class="n">sections</span>
 </pre></div>
 </div>

install.html

@@ -73,6 +73,21 @@ <h3>OCI Configuration<a class="headerlink" href="#oci-configuration" title="Link
 </div>
 <p>Follow the prompts to authenticate with your tenancy. If you don’t know your
 region, open the OCI Web UI and see what it defaults to.</p>
+<p>Please note: if you encounter an error message in the above command which
+contains the code <code class="docutils literal notranslate"><span class="pre">NotAuthorizedOrNotFound</span></code>, then there’s an alternative way
+to setup your OCI credentials:</p>
+<ol class="arabic simple">
+<li><p>Run <code class="docutils literal notranslate"><span class="pre">oci</span> <span class="pre">setup</span> <span class="pre">keys</span></code>. At the prompt, you probably want to type “N/A” to
+avoid setting a passphrase for the key.</p></li>
+<li><p>Open the OCI web console. Navigate to your profile using the icon at the top
+right (or search your email address in the search bar). On your profile page,
+select the “API keys” link, and then choose “Add API key”.</p></li>
+<li><p>Use “choose public key file” to upload the <strong>public key</strong> generated by step
+1, and click submit. The resulting page should contain a fragment of
+configuration file.</p></li>
+<li><p>Paste the configuration fragment into <code class="docutils literal notranslate"><span class="pre">~/.oci/config</span></code>. Be sure to set
+<code class="docutils literal notranslate"><span class="pre">key_file</span></code> to the name of your <strong>private</strong> key.</p></li>
+</ol>
 </section>
 <section id="yo-configuration">
 <h3>yo Configuration<a class="headerlink" href="#yo-configuration" title="Link to this heading">¶</a></h3>