Getting started cleanup

[mike-scott]

Fix some "easy" issues with our Getting Started documentation.

• Drop the CI selection page. Too complicated for a Getting Started guide.
• Move fioctl installation and build/deploy application pages out a level so that they apply to both the container-only and lmp-based workflows
• Fixup the title (grammar) for the "Building and Deploying an Application" page

PR Template and Checklist

Please complete as much as possible to speed up the reviewing process.
You may delete items that are not relevant to your contribution.
Readiness and adding reviewers as appropriate is required.

All PRs should be reviewed by a technical writer/documentation team and a peer.
If effecting customers—which is a majority of content changes—a member of Customer Success must also review.

Readiness

• Merge (pending reviews)
• Merge after date or event
• Draft

Checklist

• Run spelling and grammar check, preferably with linter.
• Step through instructions (or ask someone to do so).
• Review for wordiness
• Match tone and style of page/section.
• Run make linkcheck, and add redirects for any moved or deleted pages.
• View HTML in a browser to check rendering.
• Use semantic newlines.
• follow best practices for commits.
  • Descriptive title written in the imperative.
  • Include brief overview of QA steps taken.
  • Mention any related issues numbers.
  • End message with sign off/DCO line (-s, --signoff).
  • Sign commit with your gpg key (-S, --gpg-sign).
  • Squash commits if needed.
• Request PR review by a technical writer and at least one peer.

Comments

Any thing else that a maintainer/reviewer should know.
This could include potential issues, rational for approach, etc.

[Tim-Anderson]

LGTM

[doanac]

This doesn't hurt. I think the bigger problem that I don't know how to sort out yet is the basics of the navigation:

ie - how do you get them through an UnoQ getting started without them finding their way into the LmP stuff where we get into stuff like flashing devices.

[vanmaegima]

@mike-scott in https://docs.foundries.io/96/getting-started/fioup-registration/index.html we see links to install, register and update with fioup. Should this be part of the main docs instead?

I suggest we keep the simplified steps in the main docs, and we can cover 'Advanced' and 'Optional' steps in the fioup docs. For example: https://github.com/foundriesio/fioup/blob/main/docs/register-device.md - we can keep 'Recomended' only in the main docs.

[mike-scott]

@mike-scott in https://docs.foundries.io/96/getting-started/fioup-registration/index.html we see links to install, register and update with fioup. Should this be part of the main docs instead?

I suggest we keep the simplified steps in the main docs, and we can cover 'Advanced' and 'Optional' steps in the fioup docs. For example: https://github.com/foundriesio/fioup/blob/main/docs/register-device.md - we can keep 'Recomended' only in the main docs.

We should add the steps we want users to do into the fioup section (instead of linking them to GitHub). I didn't include that change here because I thought it might take more time to get in and review.

[mike-scott]

This doesn't hurt. I think the bigger problem that I don't know how to sort out yet is the basics of the navigation:

ie - how do you get them through an UnoQ getting started without them finding their way into the LmP stuff where we get into stuff like flashing devices.

Yep. I have an open discussion with @kprosise to see if we can fix the "Next" link at the end of the Container-Only setup section. It should take the user straight to the fioctl steps (skipping the LmP setup)

[angolini]

the way the docs is today is unfeasible to be maintained. Changing one button or one order will not solve the problem. This PR per-se does not hurt, but also does not address the issue.

Let's merge this PR and keep discussing how to progress to fix GS (which today is broken), but for that we have to have a decision on what is the real priority (which is something that is still vague today)

[kprosise]

LGTM. Do we want to add a redirect for the deleted page? I could always add it in a follow up PR too.

[kprosise]

Thanks!