User guide was not migrated to the nova repo

The Link to the Lost Article Screenshot

It seems that documentation is being rewritten now. This changes will affect the structure of the OpenStack documentation.

I found an article that can replace the 'Provide user data to instance' article partially.
Link to this article (to 'User data' item):
https://docs.openstack.org/python-openstackclient/latest/cli/command-objects/server.html#cmdoption-openstack-server-create-user-data

I pointed this link in this review to another bug:
https://review.openstack.org/#/c/498835/

Changes: https://review.openstack.org/#/c/498835/4/doc/source/glossary.rst

Thank you for attention!

Not sure why heat was listed here, so mark it as an opinion for now. We surely welcome any improvement with document, but it's not a bug IMO.

Set the status "In Progress" because this report has an assignee.

Marking the python-novaclient component as invalid as these docs belong in the nova tree alone

I don't see any nova proposed changes for this and I'd like to see this fixed sooner than later so we can backport to stable/pike. Is someone working on this?

Since we want to backport the docs fix to stable/pike, I'd suggest doing this in two steps:

1. Migrate the user guide docs to the nova repo in their current form so they are easy to backport to stable/pike.

2. Then on the master branch only, cleanup the docs, e.g. the config drive doc has both user and admin information in it that could be split up into user and admin docs.

Fix proposed to branch: master
Review: https://review.openstack.org/514723

Fix proposed to branch: master
Review: https://review.openstack.org/514738

I've got changes up for two pages: config-drive and user-data

These are the others that I see missing which are related to nova:

https://github.com/openstack/openstack-manuals/blob/stable/ocata/doc/user-guide/source/cli-access-instance-through-a-console.rst

https://github.com/openstack/openstack-manuals/blob/stable/ocata/doc/user-guide/source/cli-change-the-size-of-your-server.rst

https://github.com/openstack/openstack-manuals/blob/stable/ocata/doc/user-guide/source/cli-delete-an-instance.rst

https://github.com/openstack/openstack-manuals/blob/stable/ocata/doc/user-guide/source/cli-launch-instances.rst

https://github.com/openstack/openstack-manuals/blob/stable/ocata/doc/user-guide/source/cli-manage-instances-hosts.rst

https://github.com/openstack/openstack-manuals/blob/stable/ocata/doc/user-guide/source/cli-manage-ip-addresses.rst

https://github.com/openstack/openstack-manuals/blob/stable/ocata/doc/user-guide/source/cli-nova-configure-access-security-for-instances.rst

https://github.com/openstack/openstack-manuals/blob/stable/ocata/doc/user-guide/source/cli-nova-launch-instance-from-image.rst

https://github.com/openstack/openstack-manuals/blob/stable/ocata/doc/user-guide/source/cli-nova-launch-instance-from-volume.rst

https://github.com/openstack/openstack-manuals/blob/stable/ocata/doc/user-guide/source/cli-nova-launch-instance-using-ISO-image.rst

https://github.com/openstack/openstack-manuals/blob/stable/ocata/doc/user-guide/source/cli-reboot-an-instance.rst

https://github.com/openstack/openstack-manuals/blob/stable/ocata/doc/user-guide/source/cli-stop-and-start-an-instance.rst

https://github.com/openstack/openstack-manuals/blob/stable/ocata/doc/user-guide/source/cli-use-snapshots-to-migrate-instances.rst

https://github.com/openstack/openstack-manuals/blob/stable/ocata/doc/user-guide/source/configure-access-and-security-for-instances.rst (NOTE: this one seems very redundant with cli-nova-configure-access-security-for-instances.rst)

Fix proposed to branch: master
Review: https://review.openstack.org/514761

Fix proposed to branch: stable/pike
Review: https://review.openstack.org/515053

Fix proposed to branch: stable/pike
Review: https://review.openstack.org/515054

Reviewed: https://review.openstack.org/514723
Committed: https://git.openstack.org/cgit/openstack/nova/commit/?id=59bd2f6adc1777c7c8d7a2f442be965fecb573a0
Submitter: Zuul
Branch: master

commit 59bd2f6adc1777c7c8d7a2f442be965fecb573a0
Author: Matt Riedemann <email address hidden>
Date: Tue Oct 24 11:51:47 2017 -0400

    Import the config drive docs from openstack-manuals

    As part of the docs migration from openstack-manuals to
    nova in the pike release we missed the config-drive docs.

    This change does the following:

    1. Imports the config-drive doc into the user guide.
    2. Fixes a broken link to the metadata service in the doc.
    3. Removes a note about liberty being the current release.
    4. Adds a link in the API reference parameters to actually
       point at the document we have in tree now, which is
       otherwise not very discoverable as the main index does
       not link to this page (or the user index for that matter).

    Partial-Bug: #1714017
    Closes-Bug: #1720873

    Change-Id: I1d54e1f5a1a94e9821efad99b7fa430bd8fece0a

Reviewed: https://review.openstack.org/514738
Committed: https://git.openstack.org/cgit/openstack/nova/commit/?id=3fc85389e5e500e25cebf4d89094e7d06bf63605
Submitter: Zuul
Branch: master

commit 3fc85389e5e500e25cebf4d89094e7d06bf63605
Author: Matt Riedemann <email address hidden>
Date: Tue Oct 24 12:19:24 2017 -0400

    Import user-data page from openstack-manuals

    This imports the "provide-user-data-to-instances" page
    from the old openstack-manuals user guide.

    Since we don't have a glossary, the :term: link is removed
    and replaced with just giving the glossary definition as
    the first part of the doc.

    Change-Id: Iae70d9b53d6cefb3bcb107fe68499cccb71fc15e
    Partial-Bug: #1714017

Reviewed: https://review.openstack.org/514761
Committed: https://git.openstack.org/cgit/openstack/heat/commit/?id=9a5252ae6ed3f49ec8bd59032c9374b3cb77f78e
Submitter: Zuul
Branch: master

commit 9a5252ae6ed3f49ec8bd59032c9374b3cb77f78e
Author: Matt Riedemann <email address hidden>
Date: Tue Oct 24 12:51:45 2017 -0400

    docs: fix user-data end user guide link

    The user-data doc has moved out of the openstack-manuals
    repo and into the nova docs, so this updates the link.

    Change-Id: I6fac7128f8c099deaea31b3834cab0e472bc10fe
    Closes-Bug: #1714017

This issue was fixed in the openstack/heat 10.0.0.0b3 development milestone.

Fix proposed to branch: master
Review: https://review.openstack.org/540048

Reviewed: https://review.openstack.org/540048
Committed: https://git.openstack.org/cgit/openstack/nova/commit/?id=4ed5e81ee0a7df28547d87e28f2eabe395d4737d
Submitter: Zuul
Branch: master

commit 4ed5e81ee0a7df28547d87e28f2eabe395d4737d
Author: Matt Riedemann <email address hidden>
Date: Thu Feb 1 12:27:59 2018 -0500

    Migrate "launch instance" user guide docs

    This imports the "launch instance" end user guide docs from
    the openstack-manuals repo. As part of the docs migration
    in Pike, these were forgotten. The copied contents come from
    the stable/ocata branch of openstack-manuals, and therefore
    likely need some updating, but that could be done in follow up
    changes. This is an initial import to (1) publish the content
    again somewhere and (2) fix broken links in the cinder docs
    for booting from volume.

    Change-Id: Ie039322660fd0e2e0403843448379b78114c425b
    Partial-Bug: #1714017
    Related-Bug: #1711267

Fix proposed to branch: stable/pike
Review: https://review.openstack.org/540495

Reviewed: https://review.openstack.org/540495
Committed: https://git.openstack.org/cgit/openstack/nova/commit/?id=2d49eb8e4f5aaff88ee7288d4fadd07c0e2e499d
Submitter: Zuul
Branch: stable/pike

commit 2d49eb8e4f5aaff88ee7288d4fadd07c0e2e499d
Author: Matt Riedemann <email address hidden>
Date: Thu Feb 1 12:27:59 2018 -0500

    Migrate "launch instance" user guide docs

    This imports the "launch instance" end user guide docs from
    the openstack-manuals repo. As part of the docs migration
    in Pike, these were forgotten. The copied contents come from
    the stable/ocata branch of openstack-manuals, and therefore
    likely need some updating, but that could be done in follow up
    changes. This is an initial import to (1) publish the content
    again somewhere and (2) fix broken links in the cinder docs
    for booting from volume.

    Conflicts:
          doc/source/index.rst

    NOTE(mriedem): The conflict is due to not having change
    Ia57c93ef1e72ccf134ba6fc7fcb85ab228d68a47 in pike.

    Change-Id: Ie039322660fd0e2e0403843448379b78114c425b
    Partial-Bug: #1714017
    Related-Bug: #1711267
    (cherry picked from commit 4ed5e81ee0a7df28547d87e28f2eabe395d4737d)

Reviewed: https://review.openstack.org/515053
Committed: https://git.openstack.org/cgit/openstack/nova/commit/?id=2c77e4f7c48e8d3984400169bfb1b60ee7004032
Submitter: Zuul
Branch: stable/pike

commit 2c77e4f7c48e8d3984400169bfb1b60ee7004032
Author: Matt Riedemann <email address hidden>
Date: Tue Oct 24 11:51:47 2017 -0400

    Import the config drive docs from openstack-manuals

    As part of the docs migration from openstack-manuals to
    nova in the pike release we missed the config-drive docs.

    This change does the following:

    1. Imports the config-drive doc into the user guide.
    2. Fixes a broken link to the metadata service in the doc.
    3. Removes a note about liberty being the current release.
    4. Adds a link in the API reference parameters to actually
       point at the document we have in tree now, which is
       otherwise not very discoverable as the main index does
       not link to this page (or the user index for that matter).

    Partial-Bug: #1714017
    Closes-Bug: #1720873

    Change-Id: I1d54e1f5a1a94e9821efad99b7fa430bd8fece0a
    (cherry picked from commit 59bd2f6adc1777c7c8d7a2f442be965fecb573a0)

Fix proposed to branch: master
Review: https://review.openstack.org/612730

Reviewed: https://review.openstack.org/612730
Committed: https://git.openstack.org/cgit/openstack/nova/commit/?id=9de70aed23a28dca90dd3e860a5951d4e1a79e44
Submitter: Zuul
Branch: master

commit 9de70aed23a28dca90dd3e860a5951d4e1a79e44
Author: Matt Riedemann <email address hidden>
Date: Tue Oct 23 11:25:36 2018 -0400

    Migrate "reboot an instance" user guide docs

    This imports the cli-reboot-an-instance end user guide docs from
    the openstack-manuals repo [1]. As part of the docs migration
    in Pike, these were forgotten. The copied contents come from
    the stable/ocata branch of openstack-manuals [2].

    There are two minor content changes from the original:

    1. The "shutdown_timeout" config option is linked to the docs.

    2. The "nova rescue" command usage is replaced with
       "openstack server rescue".

    [1] https://docs.openstack.org/ocata/user-guide/cli-reboot-an-instance.html
    [2] https://github.com/openstack/openstack-manuals/blob/stable/ocata/doc/user-guide/source/cli-reboot-an-instance.rst

    Change-Id: I6701e43fd80fb17df5cc703df766390ab838289a
    Partial-Bug: #1714017