Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Doc changes to be more explicit on .devcontainer usage for command-line deployments (vs local shell) #211

Merged
merged 11 commits into from
May 24, 2021

Conversation

bspender
Copy link
Contributor

@bspender bspender commented May 19, 2021

Description

Doc changes to be more explicit on .devcontainer usage for command-line deployments (vs local shell).

The steps for cloning the project to a local machine apply to all usage paths (i.e. development container, command line, and UI deployments), but are only documented in this development container page. The "setup" steps in this page (e.g. the steps of getting the bits to the local machine and ready to run) should be moved to top-level "getting started" page. This aims to help simplify/clarify the "Command-Line Deployment" steps by avoiding some context switching across the different getting started pages. The command-line step-by-step page was then updated to be more explicit at the beginning around whether the command was run from the local BASH shell or from the BASH shell in the devcontainer.

Issue reference

The issue this PR will close: #212

Checklist

Please make sure you've completed the relevant tasks for this PR, out of the following list:

  • Code compiles or validates correctly
  • BASH scripts have been validated using shellcheck
  • All tests pass (manual and automated)
  • [ x ] The documentation is updated to cover any new or changed features
  • [ x ] Markdown files have been linted using the recommended linter. (See .vscode/extensions.json.)
  • Relevant issues are linked to this PR

The steps for cloning the project to a local machine apply to all usage paths (i.e. development container, command line, and UI deployments), but are only documented in this development container page. The "setup" steps in this page (e.g. the steps of getting the bits to the local machine and ready to run) should be moved to top-level "getting started" page. This will also help simplify/clarify the "Command-Line Deployment" steps by avoiding some context switching across the different getting started pages.
I've personally needed to think about where I need to run these commands to deploy via command-line. This attempts to make it more explicit
Copy link
Contributor

@brooke-hamilton brooke-hamilton left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

These are great improvements - thanks for sending them.

I added an issue and linked to it in the PR description.

src/docs/getting-started.md Outdated Show resolved Hide resolved
src/docs/command-line-deployment.md Show resolved Hide resolved
src/docs/command-line-deployment.md Show resolved Hide resolved
src/docs/command-line-deployment.md Outdated Show resolved Hide resolved
@bspender bspender merged commit 79aec38 into Azure:main May 24, 2021
jwaltireland pushed a commit to ARPA-H/AzureMissionLZ that referenced this pull request Nov 14, 2024
…ne deployments (vs local shell) (Azure#211)

* Moved the project cloning steps to be here

* Move project cloning steps to Getting Started page

The steps for cloning the project to a local machine apply to all usage paths (i.e. development container, command line, and UI deployments), but are only documented in this development container page. The "setup" steps in this page (e.g. the steps of getting the bits to the local machine and ready to run) should be moved to top-level "getting started" page. This will also help simplify/clarify the "Command-Line Deployment" steps by avoiding some context switching across the different getting started pages.

* Update README.md

* Fixed the issues found by linter

* Update README.md

* Making devcontainer usage more explicit

I've personally needed to think about where I need to run these commands to deploy via command-line. This attempts to make it more explicit

* Updates after linter

* Update after linter

* Adding authentication note

* changes to step-by-step list
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Improve deployment and dev container documentation
2 participants